Vérifier manuellement si Google a indexé vos pages Web est l'une des tâches les plus fastidieuses du référencement technique. Pendant des années, la seule option consistait à utiliser l'outil d'inspection d'URL dans Google Search Console, une URL à la fois. Si vous gérez un site Web comportant des centaines ou des milliers de pages, ce processus est extrêmement lent et peu pratique.
Entrez le API d'inspection d'URL. Lancée par Google en janvier 2022, cette interface puissante permet aux développeurs et aux professionnels du référencement d'inspecter par programmation plusieurs URL à la fois, en récupérant des données d'indexation détaillées directement à partir des serveurs de Google. Avec un quota quotidien de 2 000 requêtes par propriété, l'API d'inspection d'URL transforme la façon dont les référenceurs techniques surveillent l'état du site, diagnostiquent les problèmes d'indexation et valident les balises canoniques à grande échelle.
Dans ce guide complet, nous vous expliquerons tout ce que vous devez savoir sur l'API d'inspection d'URL : de la configuration initiale et de l'authentification à l'écriture de scripts Python, en passant par l'interprétation des données de réponse et la création de flux de travail de surveillance automatisés. Que vous dirigiez un site de petite entreprise ou que vous gériez le référencement au niveau d'une entreprise, la maîtrise de l'API d'inspection d'URL vous fera gagner d'innombrables heures et vous donnera des informations plus approfondies sur la façon dont Google voit votre contenu.
Qu'est-ce que l'API d'inspection d'URL et pourquoi est-ce important ?
L'API d'inspection d'URL est un point de terminaison officiel de la console de recherche de Google qui vous permet d'interroger les données d'index de Google pour n'importe quelle URL que vous possédez. Contrairement à l'outil d'inspection d'URL manuel dans le tableau de bord GSC, qui vous limite à vérifier une page à la fois, l'API d'inspection d'URL permet des opérations groupées via le code.
Selon la documentation officielle de Google, l'API d'inspection d'URL renvoie des informations détaillées sur l'état de l'index d'une URL, l'état de la couverture, la convivialité mobile, les résultats riches, etc. Ces données proviennent directement de l'index de Google (et non de robots d'exploration tiers), ce qui en fait la source d'informations d'indexation la plus fiable disponible.
L'API d'inspection d'URL est importante car l'indexation est le fondement de la visibilité de la recherche. Si vos pages ne sont pas indexées, elles ne peuvent pas être classées. S’ils sont indexés avec des erreurs, leur classement en souffre. En utilisant l'API d'inspection d'URL pour auditer votre site en masse, vous pouvez identifier des modèles, repérer les problèmes systémiques et résoudre les problèmes avant qu'ils n'affectent votre trafic.
Certains des points de données clés fournis par l'API d'inspection d'URL incluent :
- État de couverture — Si l'URL est indexée et si elle a été soumise via le plan du site
- état d'indexation — Le verdict d'indexation actuel (INDEXING_ALLOWED, NEUTRAL, PARTIAL, etc.)
- lastCrawlTime — Quand Googlebot a visité la page pour la dernière fois
- robotsTxtState — Si robots.txt autorise ou bloque l'URL
- pageFetchState — Si Google a réussi à récupérer la page
- googleCanonical contre userCanonical — Si Google respecte votre balise canonique déclarée
- exploré en tant que — Si Google a utilisé un agent utilisateur mobile ou de bureau
- URL de référence — Pages internes renvoyant vers l'URL inspectée
- richeRésultatsRésultat — Validité des données structurées et éligibilité des résultats riches
- mobileUtilisationRésultat - Statut de convivialité mobile
Avoir accès à toutes ces données par programmation via l'API d'inspection d'URL signifie que vous pouvez créer des tableaux de bord, automatiser des rapports et intégrer des contrôles d'indexation dans vos flux de travail SEO existants.
Comprendre le quota et les limites de l'API d'inspection d'URL
Avant de plonger dans la mise en œuvre, il est important de comprendre les contraintes de l’API d’inspection d’URL. Google impose deux limites principales :
- 2 000 requêtes par jour et par propriété
- 600 requêtes par minute et par propriété
Ces limites sont spécifiques à la propriété et non au compte. Si vous disposez de plusieurs propriétés vérifiées dans Google Search Console (par exemple, des propriétés distinctes pour votre sous-domaine de blog, votre domaine principal et votre sous-domaine mobile), chacune obtient son propre quota quotidien de 2 000 requêtes. Il s’agit d’un détail critique pour les grands sites Web.
Google a conçu l'API d'inspection d'URL pour l'échantillonnage et le débogage, et non pour explorer chaque URL sur des sites volumineux. Pour un site Web de 50 000 pages, 2 000 requêtes quotidiennes signifient que vous pouvez inspecter l'intégralité de votre site pendant 25 jours. Cependant, la plupart des référenceurs utilisent l'API d'inspection d'URL de manière stratégique, en se concentrant sur les pages hautement prioritaires, le contenu nouvellement publié ou les pages signalées dans les rapports de couverture GSC.
Autre limitation importante : l'API d'inspection d'URL ne fonctionne que sur les propriétés que vous possédez et que vous avez vérifiées dans Google Search Console. Vous ne pouvez pas l'utiliser pour inspecter les URL de concurrents ou les sites auxquels vous n'avez pas accès.
Enfin, l'API d'inspection d'URL vérifie l'état de l'indexation : elle ne soumet pas d'URL pour l'indexation. Si vous devez demander l'indexation, vous devez toujours utiliser le bouton Demander l'indexation manuelle dans GSC ou le API d'indexation Google (qui est officiellement limité aux offres d'emploi et aux événements en direct, bien que certains plugins l'étendent).
Configuration du projet Google Cloud et des informations d'identification de l'API
Pour utiliser l'API d'inspection d'URL, vous avez besoin d'un projet Google Cloud Platform avec l'API Search Console activée. Voici le processus de configuration étape par étape :
Étape 1 : Créer un projet Google Cloud
Allez au Google Cloud Console et connectez-vous avec le même compte Google qui possède votre propriété Search Console. Cliquez sur le sélecteur de projet en haut et choisissez Nouveau projet. Donnez-lui un nom descriptif tel que « API d'inspection d'URL GSC » et cliquez sur Créer.
Étape 2 : Activez l'API de la Search Console
Une fois votre projet créé, accédez à API et services > Bibliothèque. Recherchez « API Google Search Console » et cliquez sur Activer. Cela active le point de terminaison de l’API d’inspection d’URL pour votre projet.
Étape 3 : Créer des informations d'identification OAuth 2.0
Accédez à API et services > Informations d’identification. Cliquez sur Créer des informations d'identification et sélectionnez ID client OAuth 2.0. Si c'est votre première fois, Google vous demandera de configurer l'écran de consentement. Choisissez Externe pour la plupart des cas d'utilisation, remplissez les informations requises sur l'application et enregistrez.
Ensuite, de retour dans la section Informations d'identification, sélectionnez Application de bureau comme type d'application (pour les scripts Python locaux) ou Application Web (pour les implémentations côté serveur). Donnez-lui un nom et cliquez sur Créer. Téléchargez le fichier d'informations d'identification JSON : il contient votre ID client et votre secret client.
Étape 4 : Vérifiez la propriété de votre console de recherche
Assurez-vous que le site Web que vous souhaitez inspecter est vérifié en tant que propriété dans Google Search Console. L’API d’inspection d’URL ne renverra que les données des propriétés vérifiées. Si vous gérez plusieurs sous-domaines ou sous-dossiers, pensez à les vérifier en tant que propriétés distinctes pour multiplier votre quota quotidien.
Écrire votre premier script Python pour l'inspection d'URL en masse
Python est le langage le plus populaire pour interagir avec l'API d'inspection d'URL en raison de sa lisibilité et des excellentes bibliothèques clientes de Google. Vous trouverez ci-dessous un script complet et prêt pour la production que vous pouvez adapter à votre propre site.
Conditions préalables
Installez les packages Python requis :
pip installer google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client pandasScript Python complet
from google.oauth2.credentials import Credentials from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build import pandas as pd import time import json # Portées requises pour l'API d'inspection d'URL SCOPES = ['https://www.googleapis.com/auth/webmasters.readonly'] def Authenticate(credentials_file): '''Authentifier auprès de Google et renvoyer le service object.''' flow = InstalledAppFlow.from_client_secrets_file( creds_file, SCOPES) creds = flow.run_local_server(port=0) return build('searchconsole', 'v1', creds=creds) def inspect_url(service, site_url, inspection_url): '''Inspectez une seule URL à l'aide de l'API d'inspection d'URL.''' request_body = { 'inspectionUrl': inspection_url, 'siteUrl' : site_url, 'langueCode' : 'en-US' } essayez : réponse = service.urlInspection().index().inspect(body=request_body).execute() return réponse.get('inspectionResult', {}) except Exception comme e : return {'error' : str(e)} def Bulk_inspect(service, site_url, url_list, delay=1): '''Inspecter plusieurs URL avec limitation de débit.''' results = [] for i, url in enumerate(url_list): print(f'Inspecting {i+1}/{len(url_list)}: {url}') result = inspect_url(service, site_url, url) results.append({ 'inspectedUrl': url, 'result': result }) time.sleep(delay) # Respecter les limites de débit renvoie les résultats def parse_results(results): '''Analyser les réponses de l'API dans un DataFrame propre.''' parsed = [] pour l'élément dans les résultats : url = item['inspectedUrl'] result = item['result'] if 'error' dans le résultat : parsed.append({ 'url': url, 'error': result['error'] }) continue index_status = result.get('indexStatusResult', {}) mobile_usability = result.get('mobileUsabilityResult', {}) rich_results = result.get('richResultsResult', {}) parsed.append({ 'url': url, 'coverageState': index_status.get('coverageState', 'N/A'), 'indexingState' : index_status.get('indexingState', 'N/A'), 'lastCrawlTime' : index_status.get('lastCrawlTime', 'N/A'), 'robotsTxtState' : index_status.get('robotsTxtState', 'N/A'), 'pageFetchState' : index_status.get('pageFetchState', 'N/A'), 'googleCanonical' : index_status.get('googleCanonical', 'N/A'), 'userCanonical' : index_status.get('userCanonical', 'N/A'), 'crawledAs' : index_status.get('crawledAs', 'N/A'), 'mobileUsability' : mobile_usability.get('verdict', 'N/A'), 'richResultsVerdict' : rich_results.get('verdict', 'N/A') }) return pd.DataFrame(parsed) # Exécution principale si __name__ == '__main__' : CREDENTIALS_FILE = 'credentials.json' SITE_URL = 'https://www.votredomaine.com/' # Liste des URL à inspecter urls_to_inspect = [ 'https://www.votredomain.com/', 'https://www.yourdomain.com/blog/post-1/', 'https://www.yourdomain.com/services/', # Ajouter plus d'URL... ] # Authentifier le service = authentifier(CREDENTIALS_FILE) # Exécuter une inspection groupée raw_results = Bulk_inspect(service, SITE_URL, urls_to_inspect) # Analyser et exporter df = parse_results(raw_results) df.to_csv('url_inspection_results.csv', index=False) print(f'Résultats enregistrés pour les URL {len(df)}')Comment fonctionne le script
Le script s'authentifie d'abord à l'aide d'OAuth 2.0, ouvrant une fenêtre de navigateur pour vous permettre d'accorder l'autorisation. Il parcourt ensuite votre liste d'URL, appelant l'API d'inspection d'URL pour chacune d'elles avec un délai d'une seconde afin de respecter la limite de 600 requêtes par minute. Les résultats sont analysés dans un DataFrame pandas et exportés au format CSV pour analyse.
Vous pouvez facilement étendre ce script pour lire les URL à partir d'un fichier XML de plan de site, l'intégrer à pipelines d'audit SEO automatisés, ou planifiez-le pour qu'il s'exécute quotidiennement à l'aide de tâches cron ou de fonctions cloud.
Interprétation des données de réponse de l'API d'inspection d'URL
Comprendre ce que renvoie l’API d’inspection d’URL est crucial pour prendre des mesures significatives. Voici une ventilation détaillée des domaines les plus importants et ce qu’ils signifient pour votre stratégie de référencement.
État de couverture
Cela vous indique l’état de couverture global de l’URL. Les valeurs communes incluent :
- Indexé, soumis dans le plan du site — L'état idéal. Google a indexé la page et elle a été trouvée via votre plan de site.
- Indexé, non soumis dans le plan du site — Google a trouvé et indexé la page par d'autres moyens (comme des liens internes), mais elle ne figure pas dans votre plan de site. Ajoutez-le.
- Soumis, non indexé — La page est dans votre plan de site mais Google ne l'a pas indexée. Cela nécessite une enquête.
- Exclu — Google a délibérément choisi de ne pas indexer la page. Recherchez les balises noindex, les problèmes canoniques ou les problèmes de qualité.
état d'indexation
Cela révèle la décision d’indexation de Google :
- INDEXING_ALLOWED — Google peut indexer la page et n'a aucune objection.
- NEUTRE — Équivalent à « Exclus » dans GSC. La page n'est pas indexée.
- PARTIEL — Équivalent à « Valide avec avertissements ». La page est indexée mais présente des problèmes.
- VERDICT_UNSPECIFIED — Google ne peut pas encore déterminer l'état de l'indexation.
googleCanonical contre userCanonical
L’un des contrôles les plus précieux fournis par l’API d’inspection d’URL est la validation canonique des balises. Lorsque ces deux valeurs diffèrent, Google a choisi une canonique différente de celle que vous avez déclarée. Cela peut se produire lorsque :
- Votre canonique déclarée utilise HTTP au lieu de HTTPS
- Le canonique pointe vers une page noindex
- Google a trouvé une page qu'il considère comme plus représentative
- Il existe des signaux de contenu en double pointant ailleurs
Utilisez une formule Excel comme =IF(A2=B2,'Auto-référencement','Ne correspond pas') pour identifier rapidement les incohérences dans vos données exportées.
lastCrawlTime
Cet horodatage indique la dernière fois que Googlebot a exploré la page. Si vous avez publié des mises à jour importantes et que la dernière heure d'exploration est ancienne, Google n'a pas encore vu vos modifications. Vous voudrez peut-être demander une nouvelle analyse ou améliorer les liens internes vers la page.
robotsTxtState et pageFetchState
Ces champs aident à diagnostiquer les obstacles au crawl. Si robotsTxtState affiche BLOCKED, votre fichier robots.txt empêche Google d'accéder à l'URL. Si pageFetchState affiche autre chose que SUCCESSFUL, recherchez les erreurs du serveur, les soft 404 ou les chaînes de redirection.
Cas d'utilisation pratiques de l'API d'inspection d'URL
L'API d'inspection d'URL brille dans plusieurs scénarios du monde réel. Voici les façons les plus efficaces dont les référenceurs et les développeurs l’utilisent.
1. Audits d'indexation post-migration
Après une migration de site (qu'il s'agisse d'un changement de domaine, d'une restructuration d'URL ou d'un passage à HTTPS), vous devez vérifier que Google a indexé vos nouvelles pages et supprimé les anciennes. Utilisez l'API d'inspection d'URL pour vérifier en masse vos nouvelles URL pour coverState et comparer googleCanonical à vos URL attendues. Simultanément, vérifiez que les anciennes URL renvoient le bon statut de redirection.
2. Surveillance de l'indexation des nouveaux contenus
Lorsque vous publiez un lot d’articles de blog ou de pages produits, vous souhaitez savoir quand Google les indexe. Configurez un script planifié à l'aide de l'API d'inspection d'URL pour vérifier quotidiennement vos dernières URL. Exportez les résultats et suivez la rapidité avec laquelle Google récupère le nouveau contenu. Si l'indexation est en retard, renforcez maillage interne à partir de pages de haute autorité.
3. Validation canonique des balises à grande échelle
Les problèmes canoniques tuent silencieusement les performances SEO. Un seul mauvais canonique peut empêcher le classement d’une section entière de votre site. Utilisez l'API d'inspection d'URL pour comparer googleCanonical et userCanonical sur vos pages clés. Signalez toute incohérence pour une correction immédiate.
4. Surveillance de l'exploration axée sur le mobile
Le champ crawledAs vous indique si Google a utilisé un agent utilisateur mobile ou de bureau. Depuis que Google est passé à l'indexation axée sur les mobiles, vous souhaitez voir MOBILE ici. Si l'exploration du bureau persiste sur des pages importantes, examinez votre convivialité mobile et votre conception réactive.
5. Bilans de santé des données structurées
La section richResultsResult indique si votre balisage de schéma est valide et éligible aux extraits enrichis. Utilisez l'API d'inspection d'URL pour auditer le schéma du produit, le schéma de la FAQ, le balisage du fil d'Ariane et d'autres types de données structurées sur votre site. Corrigez les erreurs avant qu’elles ne suppriment vos résultats enrichis.
6. Identification des pages orphelines
Le champ referUrls indique quelles pages internes renvoient à l’URL inspectée. Si cette liste est vide pour une page importante, il s'agit effectivement d'une page orpheline sans équité de lien interne. Ajoutez des liens internes contextuels à partir de pages indexées pertinentes pour aider Google à les découvrir et à les hiérarchiser.
Contourner la limite quotidienne de 2 000 requêtes
Pour les grands sites Web, la limite quotidienne de 2 000 requêtes de l’API d’inspection d’URL peut sembler restrictive. Voici des stratégies éprouvées pour maximiser votre couverture.
Stratégie 1 : vérifier plusieurs propriétés
Comme mentionné précédemment, chaque propriété vérifiée dispose de son propre quota de 2 000 requêtes. Vérifiez les sous-domaines et les sous-dossiers principaux en tant que propriétés distinctes. Par exemple, si votre site comporte blog.votresite.com et shop.votresite.com, vérifiez chacun séparément pour doubler votre capacité quotidienne.
Stratégie 2 : donner la priorité aux pages de grande valeur
Toutes les pages ne nécessitent pas une inspection quotidienne. Concentrez votre quota d'API d'inspection d'URL sur :
- Pages de destination génératrices de revenus
- Contenu récemment publié ou mis à jour
- Pages signalées dans les rapports de couverture GSC
- URL soumises à des tests A/B ou à une optimisation
- Pages présentant des problèmes d'indexation historiques
Stratégie 3 : Utiliser l'échantillonnage et la signification statistique
Plutôt que d'inspecter chaque URL, inspectez un échantillon représentatif de chaque type de modèle (page d'accueil, page de catégorie, page produit, article de blog). Si votre échantillon présente une indexation saine, le reste de ce modèle fonctionne probablement de la même manière. Réservez des analyses complètes du site pour des audits trimestriels.
Stratégie 4 : Combiner avec les données du robot
Des outils comme Screaming Frog intègrent directement l’API d’inspection d’URL. Vous pouvez explorer votre site, puis extraire les données de l'API d'inspection d'URL pour les 2 000 premières URL rencontrées. Cela combine les données d'exploration (codes de réponse, titres, méta descriptions) avec les données d'index de Google pour une analyse complète.
Automatisation des flux de travail de l'API d'inspection d'URL
La véritable puissance de l’API d’inspection d’URL apparaît lorsque vous l’automatisez. Voici trois modèles d'automatisation utilisés par les référenceurs professionnels.
Modèle 1 : surveillance programmée des index
Configurez une fonction cloud (AWS Lambda, Google Cloud Functions ou Azure Functions) qui exécute votre script Python selon une planification. Stockez les résultats dans une base de données comme BigQuery ou PostgreSQL. Créez un tableau de bord dans Looker Studio ou Tableau qui visualise les tendances d'indexation au fil du temps. Alertez les parties prenantes lorsque des pages importantes disparaissent de l’index.
Modèle 2 : intégration CI/CD
Intégrez l'API d'inspection d'URL dans votre pipeline de déploiement. Après chaque déploiement en production, inspectez automatiquement un échantillon d’URL concernées. Si coverState affiche des erreurs inattendues, bloquez le déploiement ou informez l’équipe. Cela empêche les régressions techniques du référencement d’atteindre les utilisateurs en direct.
Modèle 3 : Intégration du calendrier de contenu
Connectez votre système de gestion de contenu à l'API d'inspection d'URL. Lorsqu'un article est publié, ajoutez-le automatiquement à une file d'attente d'inspection. Vérifiez son statut d'indexation 24, 48 et 72 heures après la publication. S'il n'est pas indexé, déclenchez des recommandations de liens internes ou informez les éditeurs pour améliorer le contenu.
Erreurs courantes de l'API d'inspection d'URL et comment les corriger
Même les développeurs expérimentés rencontrent des problèmes lorsqu’ils travaillent avec l’API d’inspection d’URL. Voici les erreurs les plus courantes et leurs solutions.
| Erreur | Cause | Solution |
|---|---|---|
| 403 Interdit | Le compte ne dispose pas d'autorisation pour la propriété | Vérifiez que vous êtes propriétaire ou utilisateur complet dans GSC pour cette propriété. |
| 429 Trop de demandes | Dépassé 600 requêtes par minute | Ajouter des délais entre les requêtes (1-2 secondes) |
| 400 requêtes incorrectes | Format siteUrl ou inspectionUrl non valide | Assurez-vous que les URL correspondent au format exact de la propriété dans GSC |
| Quota dépassé | Atteint 2 000 requêtes quotidiennes | Attendez 24 heures ou utilisez une autre propriété vérifiée |
| Réponse vide | URL inconnue de Google | La page est peut-être nouvelle ; soumettre le plan du site et attendre |
Outils gratuits qui utilisent l'API d'inspection d'URL
Si l'écriture de code n'est pas votre point fort, plusieurs outils gratuits exploitent l'API d'inspection d'URL avec des interfaces conviviales :
- Inspecter en masse Valentin.app — Un outil basé sur un navigateur qui traite les données localement. Autorisez votre compte Google, collez les URL et exportez au format CSV ou Excel.
- Araignée SEO Screaming Frog — Intègre les données de l'API d'inspection d'URL directement dans les analyses avec des filtres prédéfinis pour les problèmes d'indexation.
- Ampoule de site - Un autre robot d'exploration avec prise en charge native de l'API d'inspection d'URL et rapports visuels.
- Modèles de feuilles Google - Des scripts d'application créés par la communauté qui extraient les données de l'API d'inspection d'URL dans des feuilles de calcul pour un partage facile.
Ces outils sont excellents pour les audits ponctuels ou les équipes sans développeurs dédiés. Cependant, pour une surveillance continue à grande échelle, un script personnalisé ou une intégration offrira toujours plus de flexibilité.
Meilleures pratiques pour le succès de l'API d'inspection d'URL
Pour tirer le meilleur parti de l’API d’inspection d’URL, suivez ces bonnes pratiques éprouvées :
- Validez toujours votre plan de site en premier — Avant d'inspecter des URL individuelles, assurez-vous que votre plan de site est exempt d'erreurs et soumis dans GSC. Un plan de site défectueux gaspille le quota d'inspection sur les URL que Google ne peut pas traiter correctement.
- Inspecter par modèle, et non par échantillonnage aléatoire — Regroupez les URL par type de page et inspectez les représentants de chaque groupe. Cela révèle les problèmes au niveau du modèle plus rapidement que les vérifications aléatoires.
- Documentez votre stratégie canonique — Tenir à jour un document de cartographie canonique. Lorsque l'API d'inspection d'URL présente des incohérences, effectuez des références croisées avec votre stratégie pour déterminer si le problème est intentionnel ou accidentel.
- Surveiller après chaque changement majeur — Exécutez des vérifications de l'API d'inspection d'URL après les migrations de sites, les refontes, les mises à jour de plugins ou les révisions de contenu. Des problèmes techniques de référencement apparaissent souvent lors de ces transitions.
- Combiner avec l'analyse des fichiers journaux — L'API d'inspection d'URL vous indique la vue d'index de Google. Les fichiers journaux vous indiquent le comportement d'exploration de Google. Ensemble, ils fournissent une image complète de la manière dont Google interagit avec votre site. Apprenez-en davantage dans notre guide d'analyse des fichiers journaux.
- Protégez vos informations d'identification OAuth — Ne validez jamais credences.json dans des référentiels publics. Utilisez des variables d'environnement ou des gestionnaires de secrets dans les environnements de production.
Comment l'API d'inspection d'URL s'intègre dans votre stratégie de référencement plus large
L'API d'inspection d'URL n'est pas une solution autonome : c'est un composant d'un programme de référencement technique complet. Associez-le à ces pratiques pour un impact maximal :
Utilisez l'API d'inspection d'URL en parallèle audits techniques SEO pour détecter rapidement les régressions d’indexation. Combinez-le avec Surveillance de Core Web Vitals pour garantir que les pages indexées offrent également une excellente expérience utilisateur. Liez vos découvertes à validation des données structurées des résultats riches apparaissent donc pour votre contenu indexé.
Pour les entreprises gérant de grands sites Web, l'API d'inspection d'URL devient un élément essentiel de votre Infrastructure de surveillance SEO. Il fournit les données réelles dont vous avez besoin pour prendre des décisions éclairées concernant la stratégie de contenu, l'architecture du site et l'allocation du budget d'exploration.
Si vous avez besoin d'une aide professionnelle pour configurer des flux de travail automatisés d'API d'inspection d'URL ou pour interpréter les résultats, notre Services de référencement technique l’équipe peut vous aider. Nous sommes spécialisés dans la création de solutions de surveillance personnalisées pour les entreprises de toutes tailles. Contactez-nous pour discuter de votre projet.
Conclusion
Le API d'inspection d'URL est l'un des outils les plus puissants disponibles pour les référenceurs techniques. En permettant des vérifications d'indexation groupées, une validation canonique et une surveillance automatisée, l'API d'inspection d'URL élimine le goulot d'étranglement de l'inspection manuelle d'URL et vous donne un accès direct aux données d'indexation de Google.
Que vous écriviez des scripts Python, utilisiez des outils d'exploration intégrés ou exploitiez des solutions sans code, l'intégration de l'API d'inspection d'URL dans votre flux de travail vous fera gagner du temps, détectera les problèmes plus rapidement et contribuera à garantir que vos pages les plus importantes restent visibles dans les résultats de recherche.
Commencez avec le script Python fourni dans ce guide, concentrez-vous sur vos pages les plus prioritaires et construisez à partir de là. À mesure que vous serez plus à l’aise avec l’API d’inspection d’URL, votre capacité à maintenir un site Web sain et bien indexé et classé de manière cohérente augmentera également.
Foire aux questions
L'outil d'inspection d'URL dans le tableau de bord GSC vous permet de vérifier manuellement une URL à la fois. L'API d'inspection d'URL vous permet d'inspecter par programme jusqu'à 2 000 URL par jour et par propriété à l'aide de code. Les deux accèdent aux mêmes données Google sous-jacentes, mais l'API permet des opérations groupées, l'automatisation et l'intégration avec des outils et des tableaux de bord tiers.
Non, l'API d'inspection d'URL vérifie uniquement l'état d'indexation actuel et les données associées pour les URL. Il ne soumet pas d’URL pour l’indexation ni ne demande de réexploration. Pour demander l'indexation, vous devez utiliser le bouton Demander l'indexation manuelle dans GSC ou l'API d'indexation Google distincte (qui est officiellement limitée aux offres d'emploi et aux événements diffusés en direct).
L’API d’inspection d’URL renvoie les données directement à partir de l’index de Google, ce qui en fait la source la plus fiable disponible. Cependant, comme toutes les données de Google Search Console, il peut y avoir des retards ou des écarts occasionnels. Certains référenceurs ont signalé des cas où GSC affichait « Exploré – Actuellement non indexé » pour des pages qui étaient réellement indexées et recevaient du trafic. Utilisez l'API comme outil de diagnostic, mais faites des références croisées avec les résultats de recherche réels à l'aide du site : requêtes et données d'analyse.
Google fournit des bibliothèques clientes pour Python, Java, JavaScript (Node.js), PHP, Ruby et Go. Python est le choix le plus populaire parmi les référenceurs en raison de sa simplicité et de ses vastes bibliothèques d'analyse de données comme les pandas. Vous pouvez également utiliser des outils sans code comme Google Sheets avec App Scripts si vous préférez ne pas écrire de code.
Pour les sites comportant plus de 2 000 pages importantes, utilisez ces stratégies : vérifiez les sous-domaines et les sous-dossiers en tant que propriétés distinctes pour obtenir plusieurs quotas ; donner la priorité aux pages à forte valeur ajoutée, telles que les sources de revenus et le nouveau contenu ; échantillonner par type de modèle plutôt que de vérifier chaque URL ; et combinez les données de l'API d'inspection d'URL avec des outils d'exploration comme Screaming Frog pour une couverture complète.
Lorsque googleCanonical diffère de userCanonical, Google a choisi une URL canonique différente de celle que vous avez spécifiée. Les causes courantes incluent : votre canonique utilise HTTP au lieu de HTTPS ; le canonique pointe vers une page noindex ; Google a trouvé du contenu en double et a sélectionné ce qu'il considère comme la meilleure version ; ou les signaux de liens internes sont en conflit avec votre déclaration canonique. Corrigez la cause première et assurez la cohérence sur votre site.
Non, l'API d'inspection d'URL ne fonctionne que sur les propriétés que vous possédez et que vous avez vérifiées dans Google Search Console. Vous ne pouvez pas inspecter les URL des sites concurrents ou de tout domaine auquel vous n'avez pas accès. Pour l'analyse des concurrents, utilisez des outils de référencement tiers qui estiment l'état d'indexation grâce à leurs propres méthodes d'exploration.
