Corelssi
Corelssi Agency API
1. Overview
The Agency API lets you run website audits from your own tools. Requests go through the Corelssi app proxy at https://corelssi.com/api/v1. There is no separate api.corelssi.com host today.
Create and revoke keys in the dashboard (/dashboard/api-keys). Keys are Agency-only and look like sc_live_….
2. Authentication
Send the key as a Bearer token:
Authorization: Bearer sc_live_YOUR_KEY
Session cookies also work for browser clients; API keys are for server-to-server use. Default key rate limit is 60 requests per minute.
3. Endpoints
POST /v1/auditSingle-URL audit when the body includes
url. Location + category discovery batch when the body includeslocationandcategory(returns a job immediately).POST /v1/batchQueue a batch job from an explicit
urlslist or discoverylocation+category. Returns202with ajob_id.GET /v1/batch/{job_id}Poll batch job status and results.
Dashboard session routes (history, PDF, clients, schedules, etc.) remain cookie-authenticated in the product UI and are not part of this Agency key surface.
4. Example — single audit
curl -X POST "https://corelssi.com/api/v1/audit" \
-H "Authorization: Bearer sc_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'Success returns an audit report JSON (score, checks, page snapshot, summary). Plan usage limits still apply.
5. Example — batch by URL list
curl -X POST "https://corelssi.com/api/v1/batch" \
-H "Authorization: Bearer sc_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://example.com","https://example.org"]}'curl "https://corelssi.com/api/v1/batch/JOB_ID" \ -H "Authorization: Bearer sc_live_YOUR_KEY"
6. Errors
- 400 — Invalid body (for example missing url or location+category)
- 401 — Missing or invalid API key / session
- 403 — Plan feature or verification required
- 429 — Rate limit or monthly usage exceeded
- 503 — Batch backend unavailable
- 500 — Unexpected server error
7. Legacy URL
/api/docs redirects here. Prefer /docs.
