Les équipes qui cherchent une API de classement Google veulent en général une chose précise : un appel qui renvoie à quelle position se trouve une page pour un mot-clé. Google ne publie pas cela.
Ce que Google publie, c'est un ensemble d'API qui décrivent vos propres performances, l'état de votre propre index et votre propre situation d'exploration. Elles sont réellement utiles, et elles sont toutes gratuites. Elles sont aussi structurellement incapables de répondre à la question que la plupart des gens apportent à cette recherche.
Nous avons passé une journée à mesurer ce que ces API renvoient réellement sur une propriété en direct, y compris les parties faciles à mal lire. Trois constats se sont détachés : les données arrivent avec trois jours de retard, le chiffre de position est une moyenne qui ne se reproduit pas face à un résultat en direct, et la seule API qui ressemble le plus à une vérification de classement renvoie un verdict qui, seul, ne dit rien d'utile.
Ce que Google publie réellement
Quatre surfaces sont confondues avec une API de classement. Voici à quoi chacune sert, d'après la documentation de Google elle-même.
L'API Search Analytics renvoie les clics, les impressions, le CTR et la position moyenne d'une propriété vérifiée. C'est ce qui ressemble le plus à des données de classement chez Google, et c'est la source de chaque chiffre de « position moyenne » dans la Search Console.
L'API URL Inspection renvoie l'état d'indexation d'une seule URL : si Google la connaît, si elle est indexée et, sinon, pourquoi.
L'API Indexing donne l'impression de soumettre des pages à l'indexation. La documentation de Google limite ses types pris en charge aux données structurées JobPosting et BroadcastEvent, ce qui est un cas d'usage étroit, et non une soumission générale à l'index.
L'API Custom Search JSON renvoie des résultats web pour une requête. Elle cherche dans un index que vous configurez, et elle ne vous dit pas où votre site se classe dans les résultats principaux de Google.
Aucune ne renvoie « votre position pour ce mot-clé ». Ce travail n'existe pas dans la gamme de produits de Google, et cette absence est délibérée plutôt qu'un oubli. Google n'a aucune raison commerciale de distribuer à grande échelle les données de position de concurrents.
Ce que nous avons mesuré : les données ont trois jours
Nous avons récupéré la ventilation quotidienne de notre propre propriété le 12 septembre 2026. La date la plus récente comportant des données était le 9 septembre.
Date disponible | Lignes renvoyées |
|---|---|
2026-09-02 | oui |
2026-09-03 | oui |
2026-09-04 | oui |
2026-09-05 | oui |
2026-09-06 | oui |
2026-09-07 | oui |
2026-09-08 | oui |
2026-09-09 | oui, la plus récente |
Trois jours de décalage, systématiquement. Le paramètre window compte à rebours depuis la date disponible la plus récente et non depuis aujourd'hui, ce qui est un petit piège : une demande de sept jours renvoie huit dates se terminant le 9 septembre, pas le 12 septembre.
Pour un rapport mensuel, c'est sans importance. Pour la question « la modification de page d'hier a-t-elle cassé quelque chose », c'est éliminatoire. Aucune configuration ne corrige cela. Le décalage se trouve du côté de Google.
Ce que nous avons mesuré : une position moyenne n'est pas un classement
C'est le constat le plus important, et c'est celui qui fait croire à beaucoup que Google dispose d'une API de classement qu'il garde par-devers lui.
La position moyenne est la position moyenne de votre URL sur toutes les impressions de la période, pondérée par pays, appareils et variantes de requête. Une vérification de classement en direct renvoie un chiffre, depuis un lieu, sur un appareil, à un instant. Ce sont deux mesures différentes qui partagent un nom.
Nous avons testé l'écart sur 25 requêtes tirées de nos propres données Search Console, puis vérifié les mêmes 25 mots-clés face à un SERP en direct pour les États-Unis, en anglais, sur ordinateur, à une profondeur de 100.
Résultat | Nombre |
|---|---|
Requêtes exploitables dans les deux ensembles | 23 |
Apparues dans le top 100 en direct | 14 (61 %) |
Avec des impressions Search Console mais aucun résultat en direct reproductible | 9 (39 %) |
Médiane de l'écart absolu lorsque les deux existaient | 7,4 positions |
Écart absolu moyen | 8,5 positions |
Écart le plus important | 36,6 positions |
À moins de 3 positions l'un de l'autre | 4 sur 14 |
Avec plus de 10 positions d'écart | 4 sur 14 |
Lorsque les deux mesures existent, elles divergent d'une médiane de 7,4 positions.
Deux détails comptent davantage que les moyennes.
Premièrement, neuf des 23 requêtes ont produit une position dans la Search Console mais aucun résultat en direct lors d'une vérification États-Unis, anglais, ordinateur. Ce n'est pas un bug. Les impressions s'accumulent depuis d'autres pays, d'autres langues, d'autres appareils et des surfaces d'images ou de vidéos. Une vérification unique ciblée sur une zone géographique ne les reproduira pas, et une équipe qui traite les deux chiffres comme une seule et même mesure passera une semaine à courir après un écart qui est un artefact de la méthode.
Deuxièmement, le sens n'est pas constant. La plupart des positions en direct se situaient sous la moyenne de la Search Console, ce à quoi on s'attend lorsque la moyenne inclut des surfaces plus performantes. Mais une requête a bougé de 36,6 positions dans l'autre sens, de 73,6 à 37. Il n'y a aucun facteur de correction à appliquer.
L'écart va dans les deux sens, il n'y a donc aucun facteur de correction à appliquer.
La conséquence pratique pour qui cherche une API de classement Google : les données gratuites ne vous donneront pas de position, et les données payantes ne s'accorderont pas avec elles. Les deux mesurent correctement des choses différentes. Traiter l'une comme un substitut de l'autre, c'est là que le reporting part de travers.
Là où le côté first-party est réellement irremplaçable, c'est la couverture, que nous avons mesurée séparément dans la comparaison des alternatives aux API de SERP.
Ce que renvoie l'API URL Inspection à la place
L'API URL Inspection est la seule surface de Google qui donne la sensation d'une vérification de classement, parce que vous lui donnez une URL sans mot-clé et recevez un statut en retour. Nous avons testé deux URL.
État de l'URL | Verdict | État de couverture | Heure du dernier crawl |
|---|---|---|---|
Publiée il y a environ une heure | NEUTRAL | URL inconnue de Google | Inconnue |
Publiée il y a environ neuf heures | NEUTRAL | Découverte, actuellement non indexée | Inconnue |
Les deux ont renvoyé le même verdict. Le champ qui distingue réellement les deux cas est la chaîne d'état de couverture, qui est une phrase, pas une énumération. Le champ de verdict indique NEUTRAL aussi bien pour une URL que Google n'a jamais vue que pour une URL qu'il a découverte mais pas indexée.
C'est une API utilisable et un mauvais signal de surveillance à elle seule. Si vous voulez une alerte quand une page n'est pas indexée, analysez l'état de couverture plutôt que le verdict, et attendez-vous à ce que l'heure du dernier crawl soit absente précisément pour les URL qui vous importent le plus.
Les quatre surfaces, et le travail qu'aucune ne fait
Question | Surface Google | Réponse |
|---|---|---|
Comment ai-je performé sur cette requête la semaine dernière | API Search Analytics | Oui, avec trois jours de retard, en moyenne |
Cette URL est-elle indexée | API URL Inspection | Oui, par URL, sur demande |
Où suis-je classé maintenant pour n'importe quel mot-clé | aucune | Non |
Où sont classés mes concurrents | aucune | Non |
À quoi ressemble le SERP d'un mot-clé sur lequel je ne me classe pas | aucune | Non |
Le schéma est cohérent. Les API de Google décrivent votre propriété de l'intérieur. Une question de classement se pose de l'extérieur, à propos d'une page de résultats, et Google ne fournit pas cela.
Comment combler l'écart sans payer trop cher
La configuration pratique, ce sont deux sources aux métiers différents, et non une source à qui l'on demande les deux.
Utilisez les API de Google comme vérité de référence sur votre propre propriété. Les clics, les impressions et l'état d'indexation sont des faits first-party que vous ne trouverez nulle part ailleurs, et ils sont gratuits. Récupérez-les selon un calendrier et traitez le décalage de trois jours comme une propriété de l'instrument.
Utilisez une source SERP pour la vue extérieure. Les positions en direct, les positions des concurrents et les mots-clés sur lesquels vous ne vous classez pas encore. C'est la partie payante, et elle est moins chère que ce que la plupart des équipes supposent : dans notre test, vérifier 23 mots-clés à une profondeur de 100 a coûté $0,2975, soit $0,0129 par vérification.
N'essayez pas de réconcilier les deux chiffres. Ils mesurent des choses différentes. Le bon réflexe est de les lire ensemble : la Search Console vous dit ce qui s'est passé, et une vérification en direct vous dit ce qui se passe. Quand ils divergent, regardez la composition pays et appareils de la requête avant de conclure quoi que ce soit.
La mécanique pour faire tourner les deux depuis un seul script se trouve dans notre traqueur à deux sources, et le volet coût de la moitié en direct est chiffré dans le test de vérification en masse.
Questions fréquentes
Google a-t-il une API de classement officielle ? Non. Google publie des API pour vos propres performances de recherche (Search Analytics), l'état d'indexation (URL Inspection) et deux types étroits de soumission (Indexing). Aucune ne renvoie de position pour un mot-clé.
Pourquoi la Search Console affiche-t-elle une position s'il n'existe pas d'API de classement ? Parce que la position moyenne est une métrique de performance calculée à partir de vos impressions, et non une consultation de classement. C'est la position moyenne sur toutes les impressions de la période, moyennée sur les pays, les appareils et les surfaces.
De combien les données de la Search Console sont-elles en retard ? De trois jours dans notre mesure du 12 septembre 2026, la date disponible la plus récente étant le 9 septembre. Le paramètre window compte à rebours depuis cette date, donc une demande de sept jours renvoie huit dates se terminant le jour disponible le plus récent.
L'API URL Inspection peut-elle me dire si une page est indexée ? Oui, et c'est le bon outil pour ce travail. Lisez la chaîne d'état de couverture plutôt que le champ de verdict, car le verdict renvoie NEUTRAL aussi bien pour une URL inconnue que pour une URL découverte mais non indexée.
L'API Custom Search JSON est-elle une API de classement ? Non. Elle renvoie des résultats d'un moteur de recherche que vous configurez, et non votre position dans les résultats principaux de Google.
Quel est le moyen le moins cher d'obtenir de vraies données de classement ? Vérifiez le plus petit ensemble de mots-clés sur lequel vous agissez réellement, à la profondeur qui correspond à l'endroit où vous vous classez. Les vérifications à une profondeur de 10 ont coûté $0,002 par mot-clé dans notre test et celles à une profondeur de 100 ont coûté $0,014, donc le réglage de profondeur fait bouger la facture sept fois plus que le nombre de mots-clés.
Point de vue Auspia : la réponse honnête à « existe-t-il une API de classement Google » est non, et la suite utile est d'arrêter de la chercher. Les API de Google répondent bien aux questions first-party et ne peuvent pas du tout répondre aux questions de classement. Prévoyez une petite somme pour la vue extérieure et consacrez le reste de l'effort à la partie que Google ne fera pas pour vous, à savoir décider quoi changer quand les deux chiffres divergent.
Auteur : Gabriel Finch, chercheur en récupération de recherche, relecture de plus de 1 200 réponses d'IA chez Auspia. Écrit sur l'infrastructure de recherche, les systèmes de récupération et ce que chaque source de données peut réellement voir.
