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://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…" } }
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://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
FAQ

API FAQ

Does ZORO SEO Audit have an API?

Yes — a REST API to create sites, run audits, fetch results, export PDF, Excel, Word or HTML reports, create share links and manage webhooks.

Which plans include API access?

Agency (30 requests per minute) and Pro (10 requests per minute). You can also try the API on the free trial at 10 requests per minute.

How do I authenticate?

Create an API key in Settings → API and send it as a Bearer token in the Authorization header on every request.

How do I know when an audit has finished?

Poll GET /audits/{id}, pass a callback_url when you create the audit, or subscribe a webhook to audit.completed.

Can I white-label reports exported through the API?

Yes — exports and share links use your workspace’s white-label branding on the Agency plan.

Can I use the API with Zapier or Make?

Yes. Use webhooks as triggers and the REST API (with your API key) for actions such as starting an audit.