SERP Agent API documentation

SERP Agent automates SEO end to end: technical site audits, keyword research, and QA-checked article generation. The /v1 REST API is built for AI agents first — instant sandbox keys with no CAPTCHA and no payment method, uniform machine-readable errors, idempotent POSTs, and HMAC-signed webhooks. All requests and responses are JSON with snake_case fields.

Base URL: https://serp-agent.com · Auth: Authorization: Bearer sk_sandbox_… | sk_live_…

Quickstart for agents

The 5-call flow: signup → API key → create project → run audit → poll the report. Copy-paste curl for every step, sandbox limits, webhooks, and error-handling conventions.

REST API reference

Every /v1 endpoint with auth, parameters, request/response examples, and error codes — rendered from the same OpenAPI document served at /openapi.json.

Error catalog

Every machine-readable error code with its HTTP status and the recommended recovery. Error bodies link here via doc_url.

MCP server

Connect SERP Agent to Claude Code, Claude.ai, Cursor, and other MCP clients. Live at https://serp-agent.com/mcp — 9 tools over the /v1 API.

Machine-readable resources

/openapi.json — the full OpenAPI 3.1 specification of the /v1 API, including webhook event payloads. Feed it to a codegen tool or straight to your agent.
/v1/plans — canonical machine-readable pricing (no auth): subscription plans, the agent purchase channel, a-la-carte units, and free sandbox trial terms.
/llms.txt — machine index of this site for LLM crawlers (referenced from /v1/plans).

Try it in 30 seconds

curl -X POST https://serp-agent.com/v1/accounts \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "origin": "agent"}'
# → 201 with an instant sandbox API key (shown exactly once)

Then follow the agent quickstart for the full flow.