Documentation

Reference for Agents, MCP & API

Run AI SEO reports from your website, REST API, or MCP. One key for everything.

New here? The developer overview walks through the access model before you reach the endpoint reference. Read the SEO report API overview

Authentication

All requests require a Bearer token. Create an API key in your account settings after signing up.

Header· http

Authorization: Bearer sr__live_your_api_key

Example Request

curl· bash

curl -X POST https://seoreport.dev/api/v1/reports \
  -H "Authorization: Bearer sr__live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "example.com"}'

REST API Endpoints

Base URL: https://seoreport.dev

POST/api/v1/reportsCreate a new report or reuse an existing one.

GET/api/v1/reports/:idGet report status and sections.

GET/api/v1/reports/:id/resultRead the full result payload.

GET/api/v1/reports/:id/download?format=pdf|md|txt|jsonDownload the rendered report as PDF, Markdown, text, or JSON.

Example Response

response.json· json

{
  "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
}

Reference for Agents, MCP & API

Authentication

Example Request

REST API Endpoints

Example Response

Connect your agent with the MCP URL