# 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](https://www.agentseo.dev/openapi.yaml) · [First request](https://www.agentseo.dev/docs/quickstart) · [Async response lifecycle](https://www.agentseo.dev/docs/async-jobs)

## 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

### [Search & extraction →](https://www.agentseo.dev/docs/api-reference/search)

Search results, page extraction, and SERP analysis.

-   [POST`/search`](https://www.agentseo.dev/docs/api-reference/search#post-search)
-   [POST`/extract`](https://www.agentseo.dev/docs/api-reference/search#post-extract)
-   [POST`/analyze/serp`](https://www.agentseo.dev/docs/api-reference/search#post-analyze-serp)

### [Content & page quality →](https://www.agentseo.dev/docs/api-reference/content)

Briefs, content gaps, on-page checks, internal links, and publishing decisions.

-   [POST`/content/gap`](https://www.agentseo.dev/docs/api-reference/content#post-content-gap)
-   [POST`/content/refresh-brief`](https://www.agentseo.dev/docs/api-reference/content#post-content-refresh-brief)
-   [POST`/content/serp-outline`](https://www.agentseo.dev/docs/api-reference/content#post-content-serp-outline)
-   [POST`/content/brief`](https://www.agentseo.dev/docs/api-reference/content#post-content-brief)
-   [POST`/content/draft-qa`](https://www.agentseo.dev/docs/api-reference/content#post-content-draft-qa)
-   [POST`/content/schema-plan`](https://www.agentseo.dev/docs/api-reference/content#post-content-schema-plan)
-   [POST`/content/internal-links`](https://www.agentseo.dev/docs/api-reference/content#post-content-internal-links)
-   [POST`/content/title-meta`](https://www.agentseo.dev/docs/api-reference/content#post-content-title-meta)
-   [POST`/content/keyword-map`](https://www.agentseo.dev/docs/api-reference/content#post-content-keyword-map)
-   [POST`/content/technical-qa`](https://www.agentseo.dev/docs/api-reference/content#post-content-technical-qa)
-   [POST`/content/action-plan`](https://www.agentseo.dev/docs/api-reference/content#post-content-action-plan)
-   [POST`/site/sitemap-audit`](https://www.agentseo.dev/docs/api-reference/content#post-site-sitemap-audit)
-   [POST`/serp/volatility`](https://www.agentseo.dev/docs/api-reference/content#post-serp-volatility)
-   [POST`/page/cro-qa`](https://www.agentseo.dev/docs/api-reference/content#post-page-cro-qa)
-   [POST`/content/cannibalization`](https://www.agentseo.dev/docs/api-reference/content#post-content-cannibalization)
-   [POST`/content/competitor-gap-matrix`](https://www.agentseo.dev/docs/api-reference/content#post-content-competitor-gap-matrix)
-   [POST`/content/programmatic-template`](https://www.agentseo.dev/docs/api-reference/content#post-content-programmatic-template)
-   [POST`/content-decay/detect`](https://www.agentseo.dev/docs/api-reference/content#post-content-decay-detect)

### [Rank & AI visibility →](https://www.agentseo.dev/docs/api-reference/visibility)

Rank history, local audits, AI Overview evidence, and mention tracking.

-   [POST`/audit/local`](https://www.agentseo.dev/docs/api-reference/visibility#post-audit-local)
-   [POST`/audit/local/batch`](https://www.agentseo.dev/docs/api-reference/visibility#post-audit-local-batch)
-   [POST`/ai-visibility/prompt-set`](https://www.agentseo.dev/docs/api-reference/visibility#post-ai-visibility-prompt-set)
-   [POST`/ai-overview/extract`](https://www.agentseo.dev/docs/api-reference/visibility#post-ai-overview-extract)
-   [POST`/rank/track`](https://www.agentseo.dev/docs/api-reference/visibility#post-rank-track)
-   [GET`/rank/track`](https://www.agentseo.dev/docs/api-reference/visibility#get-rank-track)
-   [POST`/local-visibility/track`](https://www.agentseo.dev/docs/api-reference/visibility#post-local-visibility-track)
-   [POST`/llm-mentions/track`](https://www.agentseo.dev/docs/api-reference/visibility#post-llm-mentions-track)

### [Keywords & competitors →](https://www.agentseo.dev/docs/api-reference/keywords)

Keyword ideas, metrics, clustering, domain comparisons, and traffic estimates.

-   [POST`/keyword-cluster/build`](https://www.agentseo.dev/docs/api-reference/keywords#post-keyword-cluster-build)
-   [POST`/keyword-ideas/suggest`](https://www.agentseo.dev/docs/api-reference/keywords#post-keyword-ideas-suggest)
-   [POST`/keyword-metrics/overview`](https://www.agentseo.dev/docs/api-reference/keywords#post-keyword-metrics-overview)
-   [POST`/domain/ranked-keywords`](https://www.agentseo.dev/docs/api-reference/keywords#post-domain-ranked-keywords)
-   [POST`/domain/relevant-pages`](https://www.agentseo.dev/docs/api-reference/keywords#post-domain-relevant-pages)
-   [POST`/domain/competitors`](https://www.agentseo.dev/docs/api-reference/keywords#post-domain-competitors)
-   [POST`/domain/intersection`](https://www.agentseo.dev/docs/api-reference/keywords#post-domain-intersection)
-   [POST`/domain/traffic-estimate`](https://www.agentseo.dev/docs/api-reference/keywords#post-domain-traffic-estimate)
-   [POST`/pages/intersection`](https://www.agentseo.dev/docs/api-reference/keywords#post-pages-intersection)

### [Backlinks →](https://www.agentseo.dev/docs/api-reference/backlinks)

Link profiles, referring domains, intersections, and outreach opportunities.

-   [POST`/backlinks/summary`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-summary)
-   [POST`/backlinks/list`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-list)
-   [POST`/backlinks/anchors`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-anchors)
-   [POST`/backlinks/referring-domains`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-referring-domains)
-   [POST`/backlinks/domain-pages`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-domain-pages)
-   [POST`/backlinks/competitors`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-competitors)
-   [POST`/backlinks/new-lost-timeseries`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-new-lost-timeseries)
-   [POST`/backlinks/page-intersection`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-page-intersection)
-   [POST`/backlinks/opportunity-finder`](https://www.agentseo.dev/docs/api-reference/backlinks#post-backlinks-opportunity-finder)

### [Opportunities & signals →](https://www.agentseo.dev/docs/api-reference/opportunities)

Find opportunities, prepare briefs, and inspect social demand signals.

-   [POST`/opportunities/find`](https://www.agentseo.dev/docs/api-reference/opportunities#post-opportunities-find)
-   [POST`/opportunities/brief`](https://www.agentseo.dev/docs/api-reference/opportunities#post-opportunities-brief)
-   [POST`/social/listen`](https://www.agentseo.dev/docs/api-reference/opportunities#post-social-listen)

### [Jobs & webhooks →](https://www.agentseo.dev/docs/api-reference/system)

Poll results, stream job events, and manage webhook delivery.

-   [GET`/webhooks/endpoints`](https://www.agentseo.dev/docs/api-reference/system#get-webhooks-endpoints)
-   [POST`/webhooks/endpoints`](https://www.agentseo.dev/docs/api-reference/system#post-webhooks-endpoints)
-   [PATCH`/webhooks/endpoints/{id}`](https://www.agentseo.dev/docs/api-reference/system#patch-webhooks-endpoints-id)
-   [DELETE`/webhooks/endpoints/{id}`](https://www.agentseo.dev/docs/api-reference/system#delete-webhooks-endpoints-id)
-   [GET`/webhooks/deliveries`](https://www.agentseo.dev/docs/api-reference/system#get-webhooks-deliveries)
-   [POST`/webhooks/deliveries/{id}/retry`](https://www.agentseo.dev/docs/api-reference/system#post-webhooks-deliveries-id-retry)
-   [GET`/jobs/{id}`](https://www.agentseo.dev/docs/api-reference/system#get-jobs-id)
-   [GET`/jobs/{id}/events`](https://www.agentseo.dev/docs/api-reference/system#get-jobs-id-events)

---
Canonical HTML: https://www.agentseo.dev/docs/api-reference
Markdown: https://www.agentseo.dev/docs/api-reference/index.md