AgentSEO / Developer documentation

Search evidence.
Ready for your workflow.

AgentSEO provides SEO data and analysis through REST, JavaScript, Python, and MCP. Start with one search request, inspect the result, then add the calls your app or agent needs.

Make your first request Browse API reference

How are you building?

Write code

Use cURL first, then integrate with JavaScript or Python.

Start the quickstart →

Use an AI agent

Read the docs as Markdown or connect your client through MCP.

Connect through MCP →

Automate a workflow

Connect HTTP calls in n8n or Make and branch on job status.

Choose an integration →

One request. A result you can inspect.

Most analysis calls run as jobs: submit the request, save its ID, and poll until it completes or fails. A queued response confirms acceptance; the completed job contains your result.

01 · Authenticate with x-api-key
02 · POST → 202 + jobId
03 · Poll → completed or failed

First search request

curl https://www.agentseo.dev/api/v1/search \
  -H "x-api-key: $AGENTSEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"seo api","limit":5,"location_code":2840}'

Set your key in a server-side environment variable. Follow the quickstart for setup and polling, or inspect recorded production responses.

Find the API for your task

Search & extraction

Search results, page extraction, and SERP analysis.

Content & page quality

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

Rank & AI visibility

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

Keywords & competitors

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

Backlinks

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

Opportunities & signals

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

Jobs & webhooks

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

Take the documentation into your editor

Use Copy page for AI on any docs page to copy its full Markdown, including examples and tables. Use a focused reference page when your agent only needs one API family.

Markdown for this page — readable without scripts or navigation.
Documentation index — find the relevant page before fetching more.
OpenAPI specification — inspect machine-readable parameters and responses.

Copying docs does not grant API access. Keep your API key in your runtime’s secret storage.

Before you automate

Handle async work

Understand polling, deadlines, retries, and terminal failures.

Know your limits

Handle rate limits and credits without blindly repeating requests.

Plans and credits · Service status · Changelog

Search evidence.Ready for your workflow.