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://zoroseoaudit.com/api/v1
What can you do with the ZORO SEO Audit API?
The ZORO SEO Audit REST API lets agencies and developers run SEO and AI-visibility audits from their own tools. You can add sites, start audits, read scores and issues as JSON, export PDF, Excel and Word reports, create share links and receive signed webhooks when an audit finishes or a score drops. Authenticate with an API key from Settings.
Authentication
Create a key in Settings → API and send it on every request:
Authorization: Bearer zsa_live_xxxxxxxxxxxxxxxxxxxxxxxx
Base URL: https://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://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