Home › API reference

ZORO SEO Audit REST API

Run audits from your own tools, client portals or automations. Available on the Agency plan (30 requests/minute) and the Pro plan (10 requests/minute). You can also try it on the free trial (10 requests/minute, the trial’s 3 audits, locked issues and PDF/HTML exports only). API audits count toward your monthly audit allowance.

https://app.zoroseoaudit.com/api/v1

Authentication

Create a key in Settings → API and send it on every request:

Authorization: Bearer zsa_live_xxxxxxxxxxxxxxxxxxxxxxxx

Base URL: https://app.zoroseoaudit.com/api/v1. Requests and responses are JSON.

Rate limits & errors

Requests per minute per key depend on the plan: 30 on Agency, 10 on Pro and on the free trial. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors use one shape:

{ "error": { "code": "audit_limit", "message": "You've used all 300 audits…" } }
StatusCodeMeaning
400invalid_url, unresolvable, private_addressThe URL can’t be audited
401unauthenticated, invalid_api_keyMissing, wrong or revoked key
402subscription_requiredSubscription inactive
403plan_upgrade_required, site_limitPlan doesn’t include this
404not_foundUnknown or other workspace’s resource
429rate_limited, audit_limitToo many requests, or monthly audits used up

Endpoints

GET/me

Plan, limits and usage for the current billing month.

GET/markets

Supported countries and languages. No authentication needed.

GET/sites

All sites in the workspace.

POST/sites

Create a site (or update it if the domain already exists).

FieldType
urlstringRequired. e.g. clientsite.com
brandstringBrand name (detected if empty)
categorystringWhat the business offers — enables AI visibility & rankings
locationstringCity or area, e.g. Austin, TX
countrystring2-letter Google market, e.g. US, AE, GB (default US). See GET /markets
languagestringSearch language, e.g. en, ar (defaults to the country’s language)
competitorsstring[]Up to 4 competitor brand names
keywordsstring[]Up to 7 target keywords
PATCH/sites/{id}

Update site fields, plus gsc_property and ga4_property (requires Google connected in the app).

POST/audits

Queue an audit. Returns 202 with the audit id. Send either site_id or url (plus any site fields above).

FieldType
site_id / urlstringWhich site to audit
max_pagesintegerPages to crawl (capped by plan: 1,000)
callback_urlhttps URLWe POST {"event":"audit.done","audit":{…}} when it finishes
curl -X POST https://app.zoroseoaudit.com/api/v1/audits \
  -H "Authorization: Bearer $ZSA_KEY" -H "Content-Type: application/json" \
  -d '{"url":"clientsite.com","category":"family dental clinic","location":"Austin, TX","max_pages":200}'
GET/audits?site_id=&limit=

Recent audits with status and scores.

GET/audits/{id}

Status while running (queued, running), then the full result: scores, all checks (295-item checklist) (status, impact, effort, finding, affected URLs, fix), AI visibility, SERP data and crawled pages. Add ?include=summary to skip the full result.

GET/audits/{id}/export/{format}

Download the report as pdf, html, xlsx (Excel) or docx (Word), with your white-label branding.

POST/audits/{id}/share

Creates a read-only report link with your white-label branding. Optional body: {"password":"…","expires_in_days":30}. Returns share_url.

GET/webhooks · POST/webhooks · DELETE/webhooks/{id}

Subscribe a URL (e.g. a Zapier or Make catch-hook) to audit.completed, audit.failed and score.dropped. POST body: {"url":"https://…","events":["audit.completed"]}; the response includes a signing secret, shown once. Each delivery carries X-Zoro-Event and X-Zoro-Signature: t=<unix>,v1=<hex>, where v1 = HMAC-SHA256(secret, "<t>.<raw body>").

DELETE/audits/{id}

Cancels a queued or running audit.

Get your API key. Start a free trial — the API is included so you can test it before you subscribe.

Start free trial