Corelssi

Corelssi Agency API

Agency plan · API keys from Dashboard → API keys

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/audit

    Single-URL audit when the body includes url. Location + category discovery batch when the body includes location and category (returns a job immediately).

  • POST /v1/batch

    Queue a batch job from an explicit urls list or discovery location + category. Returns 202 with a job_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.