REST / v1

Find the endpoint.
Build the next step.

Request parameters and examples for 58 operations. Open a task-specific reference to read or copy only what your implementation needs.

Base URL: https://www.agentseo.dev/api/v1
Authentication: x-api-key: YOUR_API_KEY

OpenAPI specification · First request · Async response lifecycle

Understand the response before chaining calls

Most analysis POST requests return 202 with a jobId, poll_url, events_url, and retry_after_seconds. Read the completed job’s result. A failed job has an error you should inspect.

Supported ?sync=true requests can still return a queued job. Extraction and webhook management are synchronous; local audit batches return multiple job IDs. Geo-targeted endpoints prefer location_code over a conflicting location name.

Browse by task