Websites as an API call.
Everything CurateOne does — generating complete AI-designed websites, capturing leads, measuring traffic — is available over a clean REST API. Bring your stack; we bring the websites.
The API is included on the Pro / Agency plan. Below it, every call answers 402 upgrade_required. A site build draws 5 AI credits, the same as in the Studio.
curl -X POST https://curateone.ai/api/v1/sites \
-H "Authorization: Bearer co_live_…" \
-H "Content-Type: application/json" \
-d '{ "businessName": "Billu Barber", "industry": "barber shop" }'
# → 202 { "jobId": "job_k2f8…" } poll /jobs/{id} until it's liveQuickstart
Create a key, call the API, and start generating your first site.
Read →Authentication
Bearer API keys — how they're issued, scoped, rotated, and revoked.
Read →API Reference
Every v1 endpoint: sites, generation jobs, leads, events, gallery, analytics, account.
Read →Webhooks
Push events to your systems on new leads and publishes — HMAC-signed.
Read →Form capture & spam protection
The public capture endpoints behind every site's forms — honeypots, reCAPTCHA v3, notification emails.
Read →Errors & rate limits
One stable error envelope, predictable codes, and how limits are enforced.
Read →Manage API keys
Create and revoke the keys attached to your CurateOne account.
Read →The whole surface
| Group | Endpoint | What it does |
|---|---|---|
| Account | GET /me | Retrieve the account |
| Sites | GET /sites | List sites |
| Sites | POST /sites | Generate a site |
| Sites | GET /sites/{id} | Retrieve a site |
| Generation jobs | GET /jobs/{id} | Poll a job |
| Generation jobs | DELETE /jobs/{id} | Cancel a job |
| Leads | GET /sites/{id}/leads | List leads |
| Events | GET /sites/{id}/events | List events |
| Events | POST /sites/{id}/events | Create an event |
| Events | GET /sites/{id}/events/{eventId}/registrations | List registrations |
| Gallery | GET /sites/{id}/gallery | List images |
| Gallery | POST /sites/{id}/gallery | Add an image |
| Analytics | GET /sites/{id}/analytics | Retrieve analytics |