Comment utiliser l'API Google Search Console ?

Q: Comment utiliser l'API Google Search Console ?

Créez un projet Cloud, activez l'API, autorisez l'accès avec OAuth, puis interrogez les données de performance, l'inspection d'URL et les sitemaps. Voici les étapes et les quotas.

Créez un projet dans la console Google Cloud, activez l'API Google Search Console, créez des identifiants OAuth 2.0 et connectez-vous avec un compte Google disposant d'un accès à la propriété. Vous pouvez ensuite envoyer des requêtes à quatre ressources : Search Analytics pour les clics, les impressions, le CTR et la position ; URL Inspection pour l'état d'indexation ; Sitemaps ; et Sites. Une clé d'API seule ne suffit pas : chaque appel exige un jeton OAuth, et des quotas limitent le volume de données que vous pouvez demander.

Ce que couvre l'API, et ce qu'elle ne couvre pas

Ressource	Méthodes	À utiliser pour
Search Analytics	`query`	Des lignes de performance par requête, page, pays, appareil, apparence dans les résultats de recherche, date ou heure
URL Inspection	`index.inspect`	La version indexée d'une URL : couverture, dernière exploration, URL canoniques
Sitemaps	`list`, `get`, `submit`, `delete`	La gestion des sitemaps soumis pour une propriété
Sites	`list`, `get`, `add`, `delete`	Les propriétés du compte connecté

C'est toute l'API. Les liens, les statistiques sur l'exploration, le rapport d'indexation des pages et le rapport Core Web Vitals n'ont pas de point de terminaison : ils restent donc accessibles uniquement dans l'interface de Search Console. URL Inspection indique ce qui figure dans l'index de Google, et non le résultat d'un test en direct de la page.

Configurer l'accès

Dans la console Google Cloud, créez un projet ou choisissez-en un.
Activez l'API Google Search Console pour ce projet.
Configurez l'écran de consentement OAuth et créez un ID client OAuth.
Demandez un scope : https://www.googleapis.com/auth/webmasters.readonly pour la lecture, ou https://www.googleapis.com/auth/webmasters pour pouvoir aussi soumettre ou supprimer des sitemaps.
Connectez-vous avec un compte autorisé sur la propriété. La lecture des données de performance exige au moins un accès en lecture ; l'API voit exactement ce que voit ce compte.

Votre première requête Search Analytics

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

Le site se place dans le chemin, encodé pour une URL : sc-domain:example.com pour une propriété de domaine, ou le préfixe exact avec sa barre oblique finale, comme https://www.example.com/, pour une propriété de préfixe d'URL. Les champs les plus importants :

Les dates sont inclusives et exprimées en heure du Pacifique.
type vaut web par défaut ; les autres valeurs sont image, video, news, googleNews et discover. Chacune nécessite sa propre requête.
Les filtres se placent dans dimensionFilterGroups, avec des opérateurs allant de equals et contains à includingRegex et excludingRegex (syntaxe RE2).
rowLimit va de 1 à 25 000 (1 000 par défaut) ; startRow permet de parcourir le reste des résultats.
dataState vaut final par défaut ; all ajoute les jours récents, pas encore définitifs, et hourly_all fonctionne avec la dimension hour.

Chaque ligne renvoie keys, clicks, impressions, ctr (de 0 à 1) et position, triées par clics, sauf si vous regroupez par date.

Les limites qui structurent votre code

50 000 lignes par jour et par type de recherche. Parcourez les résultats avec startRow par pas de 25 000 et arrêtez-vous à la première réponse vide. Pour en obtenir le maximum, interrogez un seul jour à la fois.
Quota de charge. Regrouper ou filtrer à la fois par page et par requête est la demande la plus coûteuse, et les longues plages de dates coûtent plus cher que les courtes. Si vous dépassez le quota à court terme, Google vous demande d'attendre 15 minutes.
Débit des requêtes. 1 200 requêtes par minute par site et par utilisateur ; 40 000 par minute et 30 000 000 par jour par projet.
Quota d'URL Inspection. 2 000 inspections par jour et 600 par minute pour chaque propriété.
16 mois d'historique, et les données sont généralement disponibles deux à trois jours après la fin de la journée.
Les lignes ne s'additionnent pas pour donner les totaux. Les requêtes rares sont exclues des lignes au niveau de la requête, et le regroupement par page compte les impressions différemment du regroupement par propriété ; lisez donc les totaux dans une requête sans la dimension query.

Erreurs courantes

Utiliser http:// alors que la propriété est en https://, ou omettre la barre oblique finale, provoque une erreur d'autorisation même si le compte a bien accès.
Demander dans URL Inspection une URL extérieure à la propriété est refusé : l'URL doit se trouver sous le siteUrl que vous transmettez.
Un mois regroupé par requête et par page en un seul appel ne renvoie que les premières lignes. Des requêtes quotidiennes en renvoient davantage.

Comment AutoPSEO vous aide

Si vous préférez ne pas gérer vous-même OAuth et la pagination, AutoPSEO se connecte via la connexion Google et expose les mêmes données grâce à sa propre REST API à l'adresse /v1 (avec un document OpenAPI 3.1) et à un serveur MCP, avec une autorisation par clé d'API obtenue dans Compte → Clés d'API. Des clés en lecture seule sont disponibles, le point de terminaison d'analyse de recherche renvoie jusqu'à 5 000 lignes par appel, et les outils d'inspection d'URL de l'application comptabilisent pour vous le quota de 2 000 par jour de Google. Consultez MCP et clés d'API. Pour conserver les données au-delà de 16 mois sans écrire de pipeline, consultez la durée de conservation des données par Search Console.

Sources : référence de l'API de Google, méthode de requête Search Analytics, limites d'utilisation, récupérer toutes vos données et guide d'autorisation.