The SERPrecon API

Run the same reports as the SERPrecon app from your own code, from AI tools like Claude Code and Cursor through our MCP server, or from the SERPrecon Chrome extension. Send a search query and the page you want to rank, and get back a score, how your page compares with the pages that rank, and a prioritized action plan.

Get your API key

How it works

1. Create a key. Sign in to SERPrecon and open Account, then API Keys. Keys use your account's credits, the same as the app.

2. Queue a report. Send the query, your page's URL, and optionally the search engine, country and language. You get a run ID back right away.

curl -X POST https://api.serprecon.com/v1/reports \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "geo share of voice tool", "url": "https://www.example.com/"}'

3. Get the results. A run takes about 2 minutes. Fetch it whenever you're ready, right away or days later, to get the score, rank, metrics and action plan.

curl https://api.serprecon.com/v1/runs/RUN_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Use SERPrecon from your AI tools

SERPrecon is also an MCP server, so AI tools like Claude Code and Cursor can run reports for you. Ask something like "run a SERPrecon report for geo share of voice tool on example.com and tell me what to fix". It uses the same API key and credits.

claude mcp add --transport http serprecon https://api.serprecon.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Where it works today. Claude Code, Cursor and other MCP clients that let you add a server with an API key. The Claude desktop app works too if you add SERPrecon to its config file; the setup is in the reference below. Adding SERPrecon as a connector in ChatGPT, or under Connectors in the Claude apps, isn't supported yet. Those need a sign-in option, which we're building now.

Building an integration with an AI coding agent like Claude Code, Codex or Cursor? Point it at our complete reference for AI agents, one plain-text file with every endpoint, field, error code, the MCP tools and worked examples: api.serprecon.com/docs/api.md (also at /llms.txt).

What the API can do

EndpointWhat it does
Reports
POST /v1/reportsCreate a report and queue its first run
POST /v1/reports/{id}/runsRe-run a report with fresh results
GET /v1/reportsList your reports, or find one by query and URL
GET /v1/reports/{id}A report and its latest score
GET /v1/reports/{id}/runsA report's run history, to track it over time
DELETE /v1/reports/{id}Delete a report
Runs
GET /v1/runs/{id}A run's status, then its full results
GET /v1/runsYour recent runs, filterable by status
Account
GET /v1/accountCredits, plan and limits
GET /v1/locationsLook up cities, regions and countries to target

What you get back

Every completed run returns the same data as a SERPrecon report.

Built for real workflows

Run one report or hundreds, on the search engines that matter.

The SERPrecon Chrome extension in Chrome's side panel, showing a page's SERPrecon score, rank, top fixes and other reports next to the page

Run reports from your browser

The free SERPrecon Chrome extension uses the same API key. Paste it into the extension's Run Report tab, and you can run reports without leaving the page you're on.

Report on the results you're looking at. Search on Google or Bing, pick your page from the results, and SERPrecon scores it against exactly those results, including a page that ranks twice.

See any page's reports as you browse. On your own pages, the extension shows the latest score, rank and top fixes, with a one-click re-run.

Report on any page. Right-click a page or link, choose a keyword, search engine, country and language, and the report runs in the background.

Stay in the flow. Get a notification when a report is ready, and keep SERPrecon open in Chrome's side panel while you browse.

The extension's on-page checks (keywords, semantic relevance, indexability, AI crawler access and Core Web Vitals) run on your device and don't use credits. Learn more about the Chrome extension or get it from the Chrome Web Store.

Questions

Insights-powered Solutions

Get Started with SERPrecon

Evolve your SEO. Leave outdated metrics behind and start analyzing your website the way a search engine does. Start your zero-risk 7-day trial today.