API + MCP

Use The Same Report Engine From The
Web, API, and MCP

Create reports programmatically, poll status, and read the same saved report object your team sees on the website.

Access model

Free account + API key

API access is account-linked. Create a free account, issue an API key, and start with score previews. No card is required for the evaluation path.

One report object

Website sessions, API calls, and agent sessions read from the same saved report state.

Straightforward flow

Create a report, poll for status, then read preview or full results from the same object.

Available endpoints

POST/api/v1/reports/preview

Create a score preview for partner and product-launch flows.

POST/api/v1/reports

Create a new report or reuse one that already exists.

GET/api/v1/reports/:id

Get the latest report status and sections.

GET/api/v1/reports/:id/download?format=json

Export the report payload as JSON for programmatic integrations.

Official TypeScript Client

Zero-config auth, free-tier ready, launch-platform ready.

See launch platform integrationView docs

Command Line

Run reports from your terminal. One global install, instant previews.

Bash
npm install -g @seoreport/client
Get your API key
Example ResponseJSON
{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}

Ready to build?

Get your free API key and start integrating SEO reports into your product.

Start a reportGet your API key