REST API v1

Robust AI SEO API
Documentation

Programmatically run SEO audits, retrieve results, and integrate Robust AI SEO into your own tools, dashboards, and workflows.

Base URL: https://robustaiseo.com
Get API Key →

Authentication

All API requests must include your API key in the Authorization header using Bearer token format. You can find your API key in Account Settings.

Request header
Authorization: Bearer rs_live_xxxxxxxxxxxxxxxxxxxxxxxx
⚠️ Keep your API key secret. Never expose it in client-side JavaScript or public repositories. Use environment variables to store it securely.

Rate Limits & Plan Limits

API access is gated by plan. Rate limits are enforced per API key per rolling 24-hour window.

PlanAPI Rate LimitPages per AuditAudit ReportsAPI Access
Free10 req/day153/mo—
Pro500 req/day50Unlimited✓
Agency2,000 req/day200Unlimited✓
EnterpriseUnlimited500Unlimited✓

Endpoints

All endpoints accept and return JSON. Errors are returned with HTTP status codes and a JSON body containing an error message.

POST/api/audit/start🔑 Auth required

Start a new SEO audit

Enqueues an audit for the given URL. Returns the audit ID you can use to poll for results. Crawl depth depends on your plan tier.

Request Body

{ "url": "https://example.com" }

Response

{ "auditId": "cuid", "status": "pending" }

Example cURL

shell
curl -X POST https://robustaiseo.com/api/audit/start \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
GET/api/audit/:id🔑 Auth required

Get audit result

Returns the full audit result including scores, findings, and recommendations. If the audit is still running, status will be "running".

Response

{ "id": "...", "status": "completed", "overallScore": 78, "findings": [...] }

Example cURL

shell
curl https://robustaiseo.com/api/audit/AUDIT_ID \
  -H "Authorization: Bearer YOUR_API_KEY"
GET/api/audit/list🔑 Auth required

List all audits

Returns all audits for your account, ordered newest first. Includes pagination via ?page=1&limit=20 query params.

Response

{ "audits": [{ "id": "...", "url": "...", "status": "completed", "overallScore": 78 }] }

Example cURL

shell
curl https://robustaiseo.com/api/audit/list \
  -H "Authorization: Bearer YOUR_API_KEY"
DELETE/api/audit/:id🔑 Auth required

Delete an audit

Permanently deletes an audit and all associated findings. This action cannot be undone.

Response

{ "success": true }

Example cURL

shell
curl -X DELETE https://robustaiseo.com/api/audit/AUDIT_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Codes

Robust AI SEO uses standard HTTP status codes. All errors include a JSON body with an error key.

StatusMeaningDescription
200OKRequest succeeded.
400Bad RequestInvalid parameters or missing required fields.
401UnauthorizedMissing or invalid API key.
403ForbiddenYour plan does not include API access.
404Not FoundThe requested resource does not exist.
429Too Many RequestsRate limit exceeded. Retry after the window resets.
500Server ErrorSomething went wrong on our end. Contact support if this persists.

Ready to integrate?

Get your API key from the settings page. Pro, Agency, and Enterprise plans include full REST API access.

Get Started Free →Talk to Sales