Vérifier la position d'un mot-clé avec une API Google : guide 2026

En résumé : Google ne publie aucune API renvoyant des positions de mots-clés en direct. L'API Search Console renvoie une position moyenne pour les requêtes sur lesquelles votre propre site vérifié se positionne déjà : gratuite, de première main, mais limitée à votre propriété et moyennée dans le temps. L'API Custom Search JSON renvoie les résultats d'un moteur personnalisé, pas ceux de google.com, donc ses positions ne correspondent pas à ce que voient les internautes. Pour de vraies positions en direct, concurrents compris, il vous faut une API SERP tierce. Ce guide donne le code qui fonctionne pour chaque voie et montre où chacune se heurte à une limite.

Chercher à vérifier la position d'un mot-clé avec une API Google fait partie de ces tâches qui ressemblent à un problème résolu jusqu'au moment où vous essayez vraiment. Il n'existe pas de point d'entrée rankings.get(), et les deux API Google vers lesquelles on se tourne d'abord répondent chacune à une question subtilement différente de celle que l'on pose. La documentation Search Analytics de la Search Console est le bon point de départ, à condition de bien comprendre ce que « position » veut dire à cet endroit.

Google propose-t-il une API officielle de positionnement ?

Non. Google n'a jamais publié d'API qui accepte un mot-clé et renvoie votre position en direct sur google.com. C'est délibéré : l'interrogation automatisée de la page de résultats est interdite par les conditions d'utilisation de Google, et l'entreprise n'a aucun intérêt commercial à fournir une infrastructure de suivi de positions.

Ce qui existe à la place, ce sont trois voies partielles, chacune avec une limite nette :

Comment récupérer des positions avec l'API Search Console ?

Interrogez le point d'entrée searchAnalytics avec la dimension query et lisez le champ position. Ce sont des données de première main directement issues de Google, c'est gratuit, et il n'y a aucune limite de mots-clés : vous obtenez toutes les requêtes pour lesquelles votre site a reçu des impressions.

La requête qui fonctionne, en Python :

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

Les trois limites qui piègent tout le monde

• La position est une moyenne, pas un classement. Une valeur de 7,4 ne signifie pas que vous êtes en position 7 : elle signifie que les impressions se répartissent sur des positions dont la moyenne est 7,4, allant peut-être de la 3 à la 15 selon les appareils et les localisations.
• Votre site uniquement. Il n'existe aucun moyen de voir la position d'un concurrent. La Search Console est une API limitée à votre propriété, par conception.
• Les mots-clés sans impression sont invisibles. Si vous êtes en position 60 et que personne n'a fait défiler jusque-là, la requête n'apparaît tout simplement pas dans les données.

C'est ce troisième point qui ruine discrètement le reporting. Un mot-clé sur lequel vous n'avez pas encore percé dans les premières pages n'existe tout bonnement pas dans la Search Console, ce qui rend impossible de mesurer une progression de la position 60 à la position 20 avec cette seule API.

Peut-on utiliser l'API Custom Search JSON pour vérifier des positions ?

Techniquement oui, utilement non. L'API Custom Search JSON exige de créer d'abord un moteur de recherche programmable. Même configuré pour chercher sur tout le web, il applique son propre classement et ses propres restrictions : l'ordre qu'il renvoie n'est donc pas celui de google.com.

Elle est aussi plafonnée à 100 requêtes par jour sur l'offre gratuite, l'usage payant étant facturé au millier de requêtes avec un plafond quotidien. Pour une poignée de mots-clés vérifiés de temps en temps, c'est utilisable. Comme outil de suivi de positions, elle produit des chiffres qui ont l'air fiables et qui sont discrètement faux, ce qui est pire que de n'avoir aucune donnée.

Et si on récupérait directement les résultats de Google ?

À éviter. L'interrogation automatisée de Google Search sans autorisation est contraire aux conditions d'utilisation de Google, et dès qu'il y a du volume, elle vous vaut des blocages d'adresse IP et des CAPTCHA. Au-delà de la question réglementaire, la réalité technique est désagréable : les résultats sont personnalisés, localisés et de plus en plus assemblés avec des fonctionnalités d'IA, si bien qu'une position récupérée de cette manière varie selon le centre de données, la localisation et la session, même quand rien n'a changé sur votre site.

Si vous avez besoin des positions de vos concurrents, une API SERP commerciale est la voie à la fois licite au regard des accords de son fournisseur et stable en exploitation. C'est une ligne de dépense, et ce coût est le prix honnête de données que Google ne donne pas. Les entreprises qui veulent faire construire et surveiller cette chaîne sans recruter en interne font en général appel à un spécialiste : notre comparatif des 10 meilleures agences data analytics en France recense les prestataires qui mettent en place ce type de reporting.

Que faut-il construire concrètement ?

Pour la plupart des équipes, l'architecture pragmatique est hybride, et elle ressemble à ceci :

• L'API Search Console comme colonne vertébrale. Gratuite, sans limite de mots-clés, de première main, et seule source qui vous dise sur quoi vous obtenez réellement des impressions.
• Une API SERP pour un petit ensemble de mots-clés choisis. Vos vingt ou trente termes commercialement critiques, vérifiés chaque jour, positions des concurrents comprises.
• Une couche de visibilité dans les IA. De plus en plus, la question n'est plus seulement « à quelle position suis-je » mais « suis-je cité quand quelqu'un interroge un assistant ». Les API de positionnement classiques ne répondent à rien de tout cela.

Les équipes qui préfèrent ne pas concevoir cela elles-mêmes le confient en général à un spécialiste : notre comparatif des 10 meilleures agences SEO en France présente les prestataires qui gèrent cette chaîne de reporting pour leurs clients.

Ce dernier point n'est pas une préoccupation d'avenir. Quand une réponse d'IA règle la requête dans l'interface, la position dix et la position trois aboutissent au même résultat : aucun clic. Suivre les citations en même temps que les positions, c'est précisément ce que font notre serveur MCP Search Console et notre plateforme de visibilité dans les IA, et la documentation couvre l'installation de bout en bout.

Conclusion

Il n'existe pas d'API Google officielle pour les positions en direct : utilisez l'API Search Console pour vos propres données moyennées, une API SERP tierce pour des positions exactes et concurrentielles, et écartez complètement l'API Custom Search JSON pour le suivi de positions. Construire sur la mauvaise est l'erreur la plus fréquente ici, et elle produit un tableau de bord aussi assuré qu'inexact.

Si vous préférez ne pas construire ni maintenir cette chaîne vous-même, Sorank connecte votre Search Console et suit les citations dans les IA au même endroit.