Documentation

Reference for Agents, MCP & API

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

Authentication

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

Header· http

Authorization: Bearer sk_your_api_key

Example Request

curl· bash

curl -X POST https://seoreport.dev/api/v1/reports \
  -H "Authorization: Bearer sk_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/artifacts/pdfDownload the rendered PDF.

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
}

Connect your agent with the MCP URL