API Search Console : comment y accéder et ce qu'elle renvoie
Par Toy Wen Da, Cofondateur · · 6 min de lecture
Traduit de l'original en anglais. Lire en anglais
L'API Search Console est l'interface programmatique de Google qui donne accès aux mêmes données que celles de Google Search Console : clics, impressions, position et statut d'indexation, mais via du code plutôt que via le tableau de bord. La première étape consiste à l'activer dans Google Cloud Console et à créer des identifiants. Vous l'autorisez ensuite sur la propriété que vous possédez déjà dans Search Console.
Avant de développer quoi que ce soit de sur mesure, vérifiez si vous avez réellement besoin d'un accès brut à l'API. La fonctionnalité de trafic du site de SearchBlueprint rassemble déjà vos chiffres Search Console, ceux de Google Analytics et les visites des robots d'IA dans une seule vue. Pour la plupart des propriétaires de sites, cela répond à la question « que se passe-t-il avec mes clics et mes impressions ? » sans écrire une seule ligne de code.
Ce que fait vraiment l'API Search Console
C'est une API REST publiée par Google qui reprend l'essentiel de ce que contient le tableau de bord de Search Console. Elle couvre les performances de recherche (requêtes, pages, pays, appareils), le statut des sitemaps et les résultats de l'inspection d'URL. Vous l'appelez depuis un script, un service backend ou un outil. Elle renvoie du JSON structuré plutôt qu'un écran à lire à la main.
Elle ne vous donne rien que Search Console ne vous montre déjà. Son intérêt tient au volume et à l'automatisation : récupérer des années de données, combiner plusieurs propriétés ou actualiser un rapport chaque matin sans que personne n'ouvre un onglet de navigateur.
Obtenir l'accès : clé API, OAuth et activation de l'API
Une simple clé API ne suffit pas ici. Les points d'accès Search Analytics de Google exigent un utilisateur ou un compte de service autorisé sur la propriété concernée, car les données sont liées à la personne qui a vérifié la propriété. Voici la marche à suivre, telle qu'elle se présente dans la console actuelle.
Étape 1 : activer l'API dans Google Cloud Console
Rendez-vous dans Google Cloud Console, sélectionnez ou créez un projet, ouvrez le menu APIs & Services, puis Library. Recherchez « Google Search Console API », cliquez dessus, puis cliquez sur Enable.
Étape 2 : créer les identifiants
Toujours dans APIs & Services, ouvrez Credentials, puis Create Credentials. Pour les scripts et les tâches de serveur à serveur, choisissez un Service Account et téléchargez sa clé JSON. Pour une application qui agit au nom d'un utilisateur connecté, choisissez plutôt un OAuth client ID.
Étape 3 : accorder l'accès dans Search Console
L'API ne voit que les propriétés auxquelles l'identité authentifiée a accès. Si vous avez créé un compte de service, copiez son adresse e-mail et ajoutez-la comme utilisateur dans Search Console. Pour cela, allez dans Settings > Users and permissions. Accordez au minimum l'accès Full ou Restricted, selon qu'il doit soumettre des sitemaps ou simplement lire les données.
Étape 4 : effectuer votre premier appel
Une fois vos identifiants en main, authentifiez-vous et appelez la méthode query de Search Analytics. Indiquez une date de début, une date de fin et des dimensions (requête, page, pays, appareil). C'est aussi à ce stade qu'un défaut de vérification a tendance à apparaître. Si le compte de service ne voit pas la propriété, cela signifie généralement que la vérification dans Search Console elle-même mérite un nouvel examen. Mieux vaut la corriger à la source avant de déboguer l'appel d'API.
Ce que vous pouvez récupérer : les points d'accès en un coup d'œil
| Point d'accès | Ce qu'il renvoie | Usage typique |
|---|---|---|
| Search Analytics query | Clics, impressions, CTR, position par requête/page/pays/appareil | Tableaux de bord de classement et de trafic |
| Sitemaps | Liste, envoi ou suppression d'entrées de sitemap | Renvoi automatisé du sitemap après une refonte |
| URL Inspection | Statut d'indexation, URL canonique, compatibilité mobile pour une URL | Vérifier si une page a été indexée après sa publication |
| Sites | Liste ou ajout des propriétés auxquelles le compte a accès | Outils multisites pour agences |
API Search Console, export manuel ou outils sans code
| Option | Idéal pour | Effort de mise en place | Principale limite |
|---|---|---|---|
| Export depuis l'interface Search Console | Une vérification unique et occasionnelle | Aucun | Nombre de lignes plafonné, pas de planification, pas d'automatisation |
| Appels directs à l'API | Tableaux de bord sur mesure, développeurs | Moyen à élevé (OAuth, code) | Vous maintenez l'authentification et le code |
| Surcouches d'API sans code | Non-développeurs qui ont tout de même besoin de JSON | Faible | Abonnement mensuel, moins de contrôle sur les champs |
| Plateformes d'intégration (iPaaS) | Produits SaaS qui intègrent des données GSC pour leurs clients | Moyen | Conçues pour les éditeurs, pas pour le reporting d'un seul site |
Les surcouches sans code existent justement pour éviter le travail sur OAuth et sur les points d'accès. Certaines, comme le connecteur Search Console de NoCodeAPI, transforment les appels Search Analytics et sitemaps en un unique point d'accès JSON authentifié. À l'autre extrémité, des éditeurs comme Paragon proposent des intégrations Search Console natives, conçues avec environ 70 % d'effort d'ingénierie en moins que si vous développiez l'OAuth et la synchronisation de zéro. Ces solutions visent les équipes SaaS qui livrent des données Search Console dans leur propre produit, pas quelqu'un qui veut simplement ses propres chiffres.
Quand les outils gratuits suffisent, et quand ils ne suffisent plus
L'interface de Search Console suffit quand vous vérifiez une seule URL ou répondez à une question ponctuelle (« cette page a-t-elle été indexée ? »). Elle convient aussi pour jeter un œil aux principales requêtes du mois dernier. Elle n'est pas conçue pour ce qui est récurrent ou multipropriété.
L'API (ou un outil construit dessus) devient rentable quand vous avez besoin de :
- Un rapport planifié qui s'actualise sans que personne n'ouvre Search Console
- Des données couvrant plus de propriétés que vous ne pouvez en parcourir à la main
- Un historique plus étendu que ce que l'interface met commodément en avant
- Des données de recherche croisées avec d'autres sources. Il est aussi utile de connaître la vraie différence entre Search Console et Analytics, car ces deux outils répondent à des questions différentes et aucun ne remplace l'autre
Erreurs courantes
- Utiliser une clé API à la place d'OAuth ou d'un compte de service. Les appels Search Analytics échoueront sans autorisation appropriée, quelle que soit la validité apparente de la clé.
- Oublier d'ajouter le compte de service comme utilisateur dans Search Console. L'identifiant d'API et l'autorisation sur la propriété sont deux étapes distinctes.
- Croire que l'API renvoie plus d'historique que l'interface. Les deux puisent dans les mêmes données ; l'avantage de l'API est l'automatisation, pas des mois d'historique supplémentaires.
- Coder en dur les plages de dates et les dimensions. Les requêtes qui ne gèrent pas correctement la pagination tronqueront silencieusement les résultats sur les sites à fort trafic.
Questions fréquentes
Dois-je payer pour utiliser l'API Search Console ?
Non. L'API elle-même est gratuite dans le respect des limites de quota standard de Google ; vous ne payez que si vous développez ou achetez un outil par-dessus.
Quelle est la différence entre une clé API et OAuth pour Search Console ?
Une clé API identifie un projet. OAuth (ou un compte de service) identifie et autorise un utilisateur ou un compte précis sur une propriété. Les données Search Analytics exigent cette seconde option.
Puis-je utiliser l'API de Search Console sans coder ?
Oui, grâce à des connecteurs sans code qui encapsulent l'API dans un point d'accès JSON plus simple. Vous devrez tout de même vous authentifier auprès de Google et gérer un compte chez ce fournisseur.
Quelle quantité de données puis-je récupérer par requête ?
La documentation de Google détaille les limites de lignes et de quota pour chaque méthode. Les comptes volumineux doivent généralement paginer leurs requêtes plutôt que de tout récupérer en un seul appel.
L'API fonctionne-t-elle pour des propriétés que je n'ai pas vérifiées ?
Non. L'accès est lié à la propriété vérifiée dans Search Console. L'identifiant que vous utilisez doit donc d'abord être ajouté comme utilisateur de cette propriété.
Pour la référence technique complète, y compris les quotas et les paramètres des méthodes, consultez la documentation de l'API Search Console de Google.
Vérifiez vos chiffres avant de développer quoi que ce soit
Si votre objectif est simplement la visibilité, les clics, les impressions et la façon dont les robots d'IA traitent vos pages, l'API Search Console n'est pas nécessaire. Évitez la configuration OAuth et consultez tout cela déjà rassemblé dans la vue de trafic du site de SearchBlueprint. Pour un regard plus large sur les performances actuelles de votre site dans la recherche, parlez à l'équipe. Vous recevrez un exemple de rapport construit à partir des données de votre propre site.
Ressources / Références
Sources
À propos de l'auteur
SearchBlueprint a recherché, rédigé et noté cet article avec la chaîne de production de contenu que nos clients utilisent sur leurs propres sites. La note affichée dans la signature est celle que notre moteur de contenu a attribuée à cette page avant sa publication. Rien ici n'est relu à la main, et c'est tout l'intérêt : c'est le résultat du produit, publié là où chacun peut le vérifier.