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…" } }
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_url, unresolvable, private_address | The URL can’t be audited |
| 401 | unauthenticated, invalid_api_key | Missing, wrong or revoked key |
| 402 | subscription_required | Subscription inactive |
| 403 | plan_upgrade_required, site_limit | Plan doesn’t include this |
| 404 | not_found | Unknown or other workspace’s resource |
| 429 | rate_limited, audit_limit | Too many requests, or monthly audits used up |
Endpoints
/mePlan, limits and usage for the current billing month.
/marketsSupported countries and languages. No authentication needed.
/sitesAll sites in the workspace.
/sitesCreate a site (or update it if the domain already exists).
| Field | Type | |
|---|---|---|
url | string | Required. e.g. clientsite.com |
brand | string | Brand name (detected if empty) |
category | string | What the business offers — enables AI visibility & rankings |
location | string | City or area, e.g. Austin, TX |
country | string | 2-letter Google market, e.g. US, AE, GB (default US). See GET /markets |
language | string | Search language, e.g. en, ar (defaults to the country’s language) |
competitors | string[] | Up to 4 competitor brand names |
keywords | string[] | Up to 7 target keywords |
/sites/{id}Update site fields, plus gsc_property and ga4_property (requires Google connected in the app).
/auditsQueue an audit. Returns 202 with the audit id. Send either site_id or url (plus any site fields above).
| Field | Type | |
|---|---|---|
site_id / url | string | Which site to audit |
max_pages | integer | Pages to crawl (capped by plan: 1,000) |
callback_url | https URL | We 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}'
/audits?site_id=&limit=Recent audits with status and scores.
/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.
/audits/{id}/export/{format}Download the report as pdf, html, xlsx (Excel) or docx (Word), with your white-label branding.
/audits/{id}/shareCreates a read-only report link with your white-label branding. Optional body: {"password":"…","expires_in_days":30}. Returns share_url.
/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>").
/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