API Google Search Console pour votre propre stack
Les données de performance de votre Search Console, sur un endpoint REST propre.
Récupérez clics, impressions, CTR et position moyenne — par requête, page et plage de dates — directement depuis Google Search Console vers votre produit, votre dashboard ou votre data warehouse. Connectez GSC une fois dans SEOcrawl AI, générez une clé Bearer depuis votre tableau de bord et appelez la REST /v1 — sans avoir à construire l'OAuth Google vous-même. C'est la même couche de données canonique que celle qui alimente le MCP de SEOcrawl AI, vos chiffres concordent donc toujours. La couverture d'indexation et l'inspection d'URL arrivent ensuite en REST ; via le MCP, elles sont déjà là.
Résolvez une propriété. Récupérez vos données GSC.
Générez un token Bearer depuis votre tableau de bord et passez-le dans l'en-tête Authorization. Résolvez une fois l'id de votre propriété Search Console, puis interrogez ses performances en REST. La même clé fonctionne sur l'API REST et sur le serveur MCP.
URL de base
https://api.seocrawl.ai/v1En-tête Authorization
Authorization: Bearer sca_live_your_token_hereToutes les métriques Search Console, en REST
Clics, impressions, CTR et position moyenne — par requête, page, plage de dates et d'une période à l'autre. Chaque endpoint est rattaché à une propriété : résolvez d'abord son id, puis lisez ses données Search Console. Ces groupes GSC sont en direct en v1 ; la couverture d'indexation et l'inspection d'URL sont exposées aujourd'hui par le MCP et arrivent ensuite en REST.
Propriétés
Listez les propriétés Search Console connectées à votre compte. Utilisez l'id de chaque propriété dans le chemin de tous les endpoints GSC.
- GET
/v1/propertiesEn direct
Performances
Total des clics, impressions, CTR et position moyenne sur une plage de dates — plus l'écart avec la période précédente sur la même fenêtre.
- GET
/v1/properties/{id}/gsc/summaryEn direct - GET
/v1/properties/{id}/gsc/compareEn direct
Requêtes
Les requêtes de recherche sur lesquelles vous apparaissez, avec leurs métriques — et l'historique quotidien complet de n'importe quel mot-clé.
- GET
/v1/properties/{id}/gsc/top-keywordsEn direct - GET
/v1/properties/{id}/gsc/keywords/detailEn direct
Pages
Vos URL les plus performantes avec leurs métriques Search Console — et le détail quotidien complet de n'importe quelle page.
- GET
/v1/properties/{id}/gsc/top-pagesEn direct - GET
/v1/properties/{id}/gsc/pages/detailEn direct
Couverture d'indexation
Ce que Google indexe vraiment : états de couverture et historique d'indexation. Déjà disponible dans le MCP ; les endpoints REST sont en cours de déploiement.
- GET
/v1/properties/{id}/indexation/summaryBientôt
Inspection d'URL
Inspection URL par URL — couverture, dernier crawl et état d'indexation d'une page donnée. Disponible dès aujourd'hui via le MCP ; la REST suit.
- GET
/v1/properties/{id}/url-inspectionBientôt
De vraies données Search Console, pensées pour les produits
Vos performances réelles dans Google Search Console — pas des estimations tierces — sur une API REST propre, avec auth Bearer et limites de débit, partageant une seule couche de données canonique avec le MCP pour que les chiffres ne se contredisent jamais.
Directement depuis Search Console
Clics, impressions, CTR et position moyenne extraits de votre propre propriété GSC — les vrais chiffres remontés par Google, pas des estimations modélisées ou scrapées. Ressources prévisibles, verbes standard, JSON typé et erreurs conformes aux RFC.
Aucun OAuth Google à construire
Connectez Search Console une fois dans SEOcrawl AI, puis lisez-la avec une seule clé Bearer sca_live_. Oubliez le projet Google Cloud, l'écran de consentement et le rafraîchissement des tokens : créez et révoquez vos clés depuis votre tableau de bord en quelques secondes.
Une seule couche de données canonique
Les endpoints REST GSC et les outils GSC du MCP sont deux frères posés sur le même provider, avec une parité testée en CI. Votre dashboard et vos agents IA voient toujours les mêmes clics, impressions et positions.
Granularité par requête et par page
Lisez les totaux d'une propriété ou descendez dans le détail : top requêtes, top pages, la tendance quotidienne d'un mot-clé ou l'historique d'une URL — les mêmes dimensions que dans Search Console, adressables en HTTP.
Comparaison de périodes intégrée
Demandez une plage (last_7_days, last_28_days, last_3_months, last_year) ou des dates from/to explicites, et obtenez la comparaison entre périodes d'office — sans second appel ni calcul de dates côté client pour réconcilier les écarts.
Limites de débit documentées
60 requêtes par minute et 1 000 par heure et par token, avec des réponses 429 + Retry-After explicites. Les limites REST forment un quota distinct de la consommation du MCP : l'un ne prive jamais l'autre.
Démarrez en 3 étapes
De zéro à votre premier appel à Search Console en quelques minutes.
Générez une clé
Connectez Search Console dans SEOcrawl AI, ouvrez Tokens d'API et générez un token Bearer. Copiez-le une seule fois : il commence par sca_live_.
Résolvez une propriété
Appelez GET /v1/properties avec Authorization: Bearer sca_live_… pour obtenir l'id (un UUID) de la propriété Search Console que vous voulez lire.
Récupérez vos données GSC
Appelez /v1/properties/{id}/gsc/summary?range=last_28_days pour les totaux, ou /gsc/top-keywords, /gsc/top-pages et les endpoints /detail — et envoyez le JSON directement dans votre produit, votre dashboard ou votre warehouse.
Trois façons d'atteindre vos données Search Console
Les mêmes chiffres GSC, des surfaces différentes — choisissez celle qui correspond à votre manière de construire.
API REST
Pour les produits, les dashboards et les pipelines de données. Auth Bearer, JSON typé, limites de débit. Vous y êtes : l'API SEO complète ajoute les endpoints de positions et de visibilité IA avec la même clé.
Serveur MCP
Pour les agents IA : Claude, ChatGPT et n'importe quel client MCP interrogent vos données Search Console en langage naturel.
Explorer le MCPTerminal & CLI
Pour les scripts et la CI/CD : pilotez vos données GSC depuis n'importe quel agent de terminal compatible MCP.
Voir le CLIQui construit sur l'API Search Console
Les équipes qui veulent de vraies données de performance GSC au sein de leurs propres systèmes.
Agences
Faites remonter les données Search Console de chaque client dans un portail sur mesure, dans Looker Studio ou dans votre couche de reporting — une clé, toutes les propriétés, sans export GSC manuel.
SaaS et partenaires
Intégrez des métriques Search Console en direct dans l'interface de votre propre produit. Offrez à vos utilisateurs clics, impressions et positions sans câbler vous-même l'API de Google.
Équipes data
Chargez clics, impressions, CTR et position GSC dans votre warehouse de façon planifiée. Croisez-les avec le revenu et construisez les modèles dont vos dashboards ont besoin.
Développeurs
Automatisez le suivi des requêtes et des pages, alertez sur les chutes de position et branchez les données Search Console sur les apps et les workflows que vous livrez déjà.
Questions fréquentes
Est-ce l'API officielle Search Console de Google ?
Non. C'est l'API REST propre à SEOcrawl AI, authentifiée en Bearer, posée sur les données Search Console que vous avez déjà connectées à votre compte. Vous connectez GSC une fois dans SEOcrawl AI, puis vous lisez clics, impressions, CTR et position avec une seule clé sca_live_ — sans créer de projet Google Cloud, d'écran de consentement OAuth ni de rafraîchissement de tokens. Les chiffres sont vos vrais chiffres Search Console ; l'API et l'authentification sont les nôtres.
Quelles données Search Console puis-je récupérer aujourd'hui ?
Les totaux sur une plage de dates (clics, impressions, CTR, position moyenne), les comparaisons entre périodes, votre top requêtes et votre top pages avec leurs métriques, et le détail quotidien complet d'un mot-clé ou d'une page — ainsi que la liste de vos propriétés connectées. La couverture d'indexation et l'inspection d'URL en direct sont déjà disponibles via le MCP ; leurs endpoints REST arrivent ensuite. Et si vous préférez lire le compte plutôt que l'interroger, l'audit Google Search Console couvre les mêmes données en un seul prompt.
Comment s'authentifier ?
Avec un token Bearer. Générez une clé sca_live_ depuis votre tableau de bord et envoyez-la en Authorization: Bearer <clé> à chaque requête. Pour votre propre compte, pas de danse OAuth : juste l'en-tête.
Quelles plages de dates sont acceptées ?
Chaque endpoint GSC accepte soit un range (last_7_days, last_28_days, last_3_months ou last_year), soit un couple from/to explicite. L'endpoint gsc/compare renvoie cette même fenêtre comparée à la période précédente : vous obtenez les écarts sans second appel.
Quelles sont les limites de débit ?
60 requêtes par minute et 1 000 par heure et par token. Au-delà, vous recevez un 429 avec un en-tête Retry-After. Les limites REST sont comptabilisées à part de la consommation du MCP : les deux ne se disputent jamais le même quota.
Est-ce la même clé et les mêmes données que le MCP ?
Oui. Le même token sca_live_ authentifie l'API REST et le serveur MCP, et tous deux lisent une seule couche de données canonique — les chiffres Search Console que vous récupérez en REST sont donc identiques à ceux que vos agents IA voient via le MCP. Un identifiant, deux surfaces.
Prêt à construire sur vos données Search Console ?
Connectez GSC une fois, générez une clé Bearer depuis votre tableau de bord et faites votre premier appel REST à Search Console en quelques minutes — ou explorez le MCP pour vos agents IA.
