Documentation

Référence pour Agents, MCP & API

Exécutez les rapports IA SEO depuis votre site web, REST API, ou MCP. Une clé pour tout

Première visite ? La page développeurs explique le modèle d'accès avant la référence des endpoints. Lire la présentation de l'API de rapport SEO

Authentification

Toutes les requêtes nécessitent un jeton Bearer. Créez une clé API dans les paramètres de votre compte après vous être inscrit

Header· http

Authorization: Bearer sr__live_your_api_key

Exemple de requête

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 Points de terminaison

URL de base https://seoreport.dev

POST/api/v1/reportsCréez un nouveau rapport ou réutilisez un rapport existant.

GET/api/v1/reports/:idObtenez le statut et les sections du rapport.

GET/api/v1/reports/:id/resultLisez la charge utile complète du résultat.

GET/api/v1/reports/:id/download?format=pdf|md|txt|jsonTéléchargez le rapport rendu en PDF, Markdown, texte ou JSON.

Réponse d'exemple

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
}

Référence pour Agents, MCP & API

Authentification

Exemple de requête

REST API Points de terminaison

Réponse d'exemple

Connectez votre agent avec l'URL MCP