API REST · v1 · Docs en direct

API SEO pour votre propre stack

Vos données SEO et de visibilité IA, sur un endpoint REST propre.

Récupérez vos données Google Search Console, de ranking et d'AI Tracker directement dans votre produit, votre dashboard ou votre data warehouse. Authentifiez-vous avec une clé Bearer depuis votre dashboard, appelez la REST `/v1` et recevez du JSON typé — la même couche de données canonique qui alimente le MCP de SEOcrawl AI. GA4, l'export complet de l'audit de site et l'OAuth multi-tenant pour partenaires arrivent ensuite.

Obtenez votre clé d'API Explorer le MCP

Auth Bearer · 60 req/min · La même couche de données que le MCP · Sans scraping

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

"metrics_diff": { "clicks": 584, … }

} }

Authentifiez-vous une fois. Appelez la REST.

Générez un token Bearer depuis votre dashboard et transmettez-le dans l'en-tête Authorization. La même clé fonctionne à la fois sur l'API REST et sur le serveur MCP.

URL de base

https://api.seocrawl.ai/v1

En-tête Authorization

Authorization: Bearer sca_live_your_token_here

Obtenez votre clé d'API Read the API docs

cURLJavaScriptPython

# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())

Endpoints

Une couche de données, deux surfaces

Chaque endpoint REST lit depuis la même couche canonique que les outils MCP — ainsi votre dashboard et vos agents IA voient toujours des chiffres identiques. Ces groupes sont en direct en v1 ; la couverture s'étend en continu.

Propriétés

Listez les propriétés Search Console auxquelles vous avez accès. Utilisez l'`id` de chaque propriété dans le path de chaque endpoint de données.

GET/v1/propertiesEn direct

Google Search Console

Clics, impressions, CTR et position moyenne — par requête, page, plage de dates et période sur période.

GET/v1/properties/{id}/gsc/summaryEn direct
GET/v1/properties/{id}/gsc/compareEn direct
GET/v1/properties/{id}/gsc/top-keywordsEn direct
GET/v1/properties/{id}/gsc/top-pagesEn direct
GET/v1/properties/{id}/gsc/keywords/detailEn direct
GET/v1/properties/{id}/gsc/pages/detailEn direct

AI Tracker

Lisez les prompts que vous surveillez pour les mentions de marque sur ChatGPT, Claude, Gemini et Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsEn direct

Tâches

Lisez et écrivez des tâches SEO — reliez votre tableau de tâches à votre propre stack de gestion de projet.

GET/v1/properties/{id}/tasksEn direct
POST/v1/properties/{id}/tasksEn direct
GET/v1/properties/{id}/tasks/{ticketId}En direct
PATCH/v1/properties/{id}/tasks/{ticketId}En direct
POST/v1/properties/{id}/tasks/{ticketId}/commentsEn direct

GA4 & indexation

Trafic, référents IA et statut d'indexation. La jonction est prête ; les endpoints REST sont en cours de déploiement.

GET/v1/properties/{id}/ga4/summaryBientôt
GET/v1/properties/{id}/indexation/summaryBientôt

Audit de site

Santé du crawl, on-page, technique et listes de problèmes — le jeu de données d'audit complet, exposé via REST.

GET/v1/properties/{id}/audit/summaryBientôt
GET/v1/properties/{id}/audit/issuesBientôt

Pourquoi cette API

Conçue pour les produits, pas pour les scrapers

Une véritable API REST avec auth Bearer, scopes et limites de débit — partageant une seule couche de données canonique avec le MCP pour que les chiffres ne divergent jamais.

REST propre, JSON typé

Ressources prévisibles, verbes standards, réponses JSON typées et erreurs conformes aux RFC (401 non authentifié, 403 scope_required, 429 avec Retry-After). Sans scraping de HTML, sans exports fragiles.

Une couche de données canonique

Les endpoints REST et les outils MCP sont frères sur les mêmes fournisseurs, avec la parité testée en CI. Votre dashboard et vos agents IA voient toujours des clics, impressions et positions identiques.

Clés en self-service

Générez et révoquez des tokens Bearer depuis votre dashboard en quelques secondes. La même clé sca_live_ authentifie à la fois l'API REST et le serveur MCP — un seul identifiant, deux surfaces.

Limites de débit documentées

60 requêtes par minute et 1,000 par heure par token, avec des réponses claires 429 + Retry-After. Les limites REST forment une réserve distincte de l'usage MCP — l'une n'affame jamais l'autre.

Accès avec scopes

Des scopes de lecture et d'écriture grossiers protègent chaque endpoint, appliqués au niveau du firewall avec des réponses de step-up standards. N'accordez à une clé que ce dont elle a besoin.

Multi-tenant, à venir

Un flux Google OAuth par tenant pour que les partenaires puissent connecter chacune des propriétés GSC de leurs clients sous un seul compte — avec une isolation stricte des données. En développement actif ; demandez-nous un accès anticipé.

Démarrez en 3 étapes

De zéro à votre premier appel authentifié en quelques minutes.

Générez une clé

Ouvrez API tokens dans votre dashboard et générez un token Bearer. Copiez-le une seule fois — il commence par `sca_live_`.

Envoyez l'en-tête

Transmettez `Authorization: Bearer sca_live_…` à chaque requête vers `https://api.seocrawl.ai/v1`. La même clé fonctionne aussi avec le serveur MCP.

Récupérez les données

Appelez `GET /v1/properties` pour obtenir un `id` de propriété, puis interrogez `/v1/properties/{id}/…` pour les performances GSC, les prompts d'AI Tracker ou les tâches — et acheminez le JSON directement dans votre produit, dashboard ou warehouse.

Trois façons d'atteindre vos données

Les mêmes chiffres, une surface différente — choisissez celle qui correspond à votre manière de construire.

API REST

Pour les produits, dashboards et pipelines de données. Auth Bearer, JSON typé, limites de débit. Vous êtes sur cette page.

Serveur MCP

Pour les agents IA — Claude, ChatGPT et tout client MCP interrogent vos données en langage naturel.

Explorer le MCP

Terminal & CLI

Pour les scripts et le CI/CD — pilotez vos données depuis n'importe quel agent de terminal compatible MCP.

Voir le CLI

Comparer toutes les intégrations

Qui construit sur l'API

Les équipes qui veulent des données SEO et de visibilité IA au sein de leurs propres systèmes.

SaaS & partenaires

Intégrez des métriques SEO en direct dans l'UI de votre propre produit. Offrez à vos utilisateurs des données Search Console et de visibilité IA sans construire vous-même les pipelines.

Agences

Acheminez les données de chaque client vers un portail sur mesure, Looker Studio ou votre couche de reporting — une seule clé, toutes les propriétés, sans exports manuels.

Équipes data

Faites atterrir vos données GSC, de ranking et d'AI Tracker dans votre warehouse selon un planning. Croisez-les avec le chiffre d'affaires et construisez les modèles dont vos dashboards ont besoin.

Développeurs

Automatisez les vérifications et les alertes, synchronisez les tâches avec votre outil de gestion de projet et reliez la surveillance de la visibilité IA aux apps que vous livrez déjà.

Questions fréquentes

Existe-t-il vraiment une API SEO publique ?

Oui — une API REST `/v1` authentifiée par Bearer est en direct, couvrant les performances de Search Console, les propriétés, les prompts d'AI Tracker et les tâches, avec la référence publique complète publiée sur api.seocrawl.ai/docs. Une couverture plus large (GA4, export complet de l'audit de site) et l'OAuth multi-tenant pour partenaires arrivent ensuite. Besoin de quelque chose qui n'est pas encore en direct ? Demandez-nous un accès anticipé.

Comment m'authentifier ?

Avec un token Bearer. Générez une clé `sca_live_` depuis votre dashboard et envoyez-la comme `Authorization: Bearer <key>` à chaque requête. Pas de danse OAuth pour votre propre compte — juste l'en-tête.

Est-ce la même clé que celle du MCP ?

Oui. Le même token authentifie à la fois l'API REST et le serveur MCP, car les deux lisent depuis une seule couche de données canonique. Un identifiant, deux surfaces — et des chiffres identiques entre les deux.

Quelles sont les limites de débit ?

60 requêtes par minute et 1,000 par heure par token. Dépassez-les et vous recevez un `429` avec un en-tête `Retry-After`. Les limites REST sont suivies séparément de l'usage MCP, ainsi les deux ne se disputent jamais le même budget.

Puis-je connecter les propriétés Search Console de mes clients ?

Ce flux multi-tenant pour partenaires — un Google OAuth par tenant pour connecter chacune des propriétés GSC de vos clients sous votre propre compte, avec une isolation stricte des données — est en développement actif. Si vous construisez une intégration partenaire, contactez-nous pour un accès anticipé.

Quelles données puis-je récupérer aujourd'hui ?

Le résumé de Search Console et les comparaisons de périodes, les keywords et pages top, le détail d'un seul mot-clé/page, votre liste de propriétés, les prompts d'AI Tracker et la lecture/écriture complète sur les tâches. Cela reflète ce que le MCP expose, via REST.

Prêt à construire sur vos données SEO ?

Générez une clé Bearer depuis votre dashboard et faites votre premier appel REST en quelques minutes — ou parlez-nous d'un accès partenaire et multi-tenant.

Obtenez votre clé d'API Réserver une démo