Clone API · v1

Clone any website with one API call.

POST a URL, get back clean, editable source - a React + Tailwind project, not a screenshot. Built for agents and back-end automation, no browser to babysit.

Get your API key Read the docs

Bearer auth · 5 credits / clone · signed webhooks · 60 req/min

POST /api/v1/clone-requests

curl -X POST https://clonesite.ai/api/v1/clone-requests \

-H "Authorization: Bearer cs_live_..." \

-H "Idempotency-Key: req_8273" \

-H "Content-Type: application/json" \

-d '{ "sourceUrl": "https://linear.app",

"prompt": "Clone as editable React." }'

202 Accepted

{

"id": "api_req_abc123",

"status": "queued",

"artifactSlug": "linear-a1b2c3",

"statusUrl": "/api/v1/clone-requests/api_req_abc123"

}

How it works

From safe test to live source

Create a key

Mint one API key in /developers and polling works immediately. Reveal a webhook secret only if you want callbackUrl deliveries.

Authorization: Bearer cs_live_...

Test the flow

First run preflight and a free test-run with your live key, including the same webhook handler you will use in production.

POST /api/v1/clone-requests/test-runs

Run it live

Create the live request, poll the status or catch clone.ready, preview the result, then download the editable source as a ZIP.

POST /api/v1/clone-requests

Async by design

Clones run in the background and finish in minutes to a few hours. Poll the status endpoint, or let a signed webhook tell you the moment it's ready.

clone.ready · clone.failed

Fair, per-clone pricing

Five credits per clone - automatically refunded if a clone fails. Source downloads are billed once, separately. No subscription, no minimums.

5 credits / clone · auto-refund

Made for agents, not browsers

One Authorization: Bearer header, free preflight/test-run endpoints, self-describing OpenAPI, and a remote MCP endpoint for agent discovery.

clonesite.ai/openapi.json · clonesite.ai/mcp

Preflight & test runs

Spend nothing until you're sure

Before the first live clone, dry-run the exact same payload. Preflight validates your key, permission, payload, credits, and webhook setup without creating a request, queuing a job, or moving a single credit. Then a free test-run rehearses the whole loop end to end.

Preflight returns canCreate and wouldChargeCredits - no request, no job, no charge
Test-runs create a free test request (mode: test) with real signed webhooks
Poll, verify webhooks, and pull a fixture source ZIP - same shapes as live, 0 credits

POST /api/v1/clone-requests/preflight

curl -X POST https://clonesite.ai/api/v1/clone-requests/preflight \

-H "Authorization: Bearer cs_live_..." \

-H "Content-Type: application/json" \

-d '{ "sourceUrl": "https://linear.app", ... }'

200 OK · no charge

{

"canCreate": true,

"wouldChargeCredits": 5,

"wouldCreateCloneRequest": false

}

free test run

curl -X POST https://clonesite.ai/api/v1/clone-requests/test-runs \

-H "Authorization: Bearer cs_live_..." \

-H "Idempotency-Key: test_8273" \

-H "Content-Type: application/json" \

-d '{ ..., "scenario": "ready" }'

# 202 · mode: test · 0 credits

# when ready: POST /source-downloads

# returns a fixture ZIP · 0 credits

Webhooks

Know the instant a clone is ready

Webhooks are optional. Polling works with the API key alone. If you pass callbackUrl, rotate one account-level signing secret in /developers; we send Standard Webhooks headers and sign each terminal event with HMAC-SHA256 over webhook-id, webhook-timestamp, and the raw body.

Account-level secret, per-request callback URLs
HMAC-SHA256 signature on every delivery
HTTPS-only callbacks, no redirects, no private hosts

POST your callback URL

webhook-id: evt_abc123

webhook-timestamp: 1781946000

webhook-signature: v1,base64(hmac_sha256(...))

{ "event": "clone.ready",

"cloneRequestId": "api_req_abc123",

"artifactSlug": "linear-a1b2c3",

"sourceZip": { "available": true, "creditCost": 100 }

}

verify

const sig = base64HmacSha256(secret, `${id}.${ts}.${body}`)

if (`v1,${sig}` !== header) return reject(401)

Use cases

What teams build on it

Ship a clone this site feature

Wrap the API behind your own product and let your users turn any URL into editable code.

Bulk-clone for migration and analysis

Turn a list of URLs into React + Tailwind source for teardowns, audits, or re-platforming.

Agent-driven cloning

Give a coding agent a key and let it clone, edit, and ship - hands-off, end to end.

Pay only when it works

5 credits / clone · 100 credits first source unlock · 60 req/min

See pricing

FAQ

Questions, answered

How long does a clone take?

Most finish within minutes; complex sites can take up to a few hours. It's fully async - you get a webhook the moment it's ready.

What do I get back?

Clean, editable source as a downloadable ZIP - a React + Tailwind project you own, not a screenshot or a hosted page.

How am I billed?

5 credits per clone, automatically refunded if it fails. Downloading the source ZIP costs 100 credits, once per clone.

Do I need an SDK?

No SDK is required. You can call the REST API directly from openapi.json, or connect an MCP-capable agent to /mcp and discover the same clone tools at runtime.

Are webhooks secure?

Yes - and they're optional. Polling only needs your API key. If you use callbackUrl, rotate an account-level signing secret in /developers, store it server-side, and verify every Standard Webhooks delivery with HMAC-SHA256.

What are the rate limits?

60 requests per minute per key. Need more headroom for a launch? Get in touch.

Can I test without spending credits?

Yes. Preflight validates your key, payload, and credits without creating anything. A free test-run rehearses the whole flow - it reaches ready and fires signed webhooks, then the same source-download endpoint returns a fixture ZIP for 0 credits.

Give your agent a key. It does the rest.

Create an API key in seconds. Add a webhook secret only if you want callbacks. You only pay when a clone succeeds.

Get your API key

clonesite.ai/developers