Combien de temps faut-il pour vérifier le statut d’indexation de dix mille URL, une par une, dans l’interface web de Search Console ? La question paraît absurde tant la réponse est évidente : des semaines de clics répétitifs, pour un résultat qui ne servira qu’un instant, puisque l’indexation évolue en continu. C’est exactement le problème que l’URL Inspection API a été conçue pour résoudre, en donnant un accès programmatique aux mêmes données que l’outil d’inspection d’URL visible dans l’interface.
Pour un développeur chargé d’auditer un site de plusieurs milliers de pages après une migration, une refonte de structure d’URL, ou simplement dans le cadre d’un contrôle régulier, la question n’est pas de choisir entre deux outils équivalents, mais de comprendre où chacun trouve sa limite.
Ce que fait la vérification manuelle
Dans l’interface de Search Console, l’outil d’inspection d’URL retourne, pour une adresse donnée, son statut d’indexation, la date de la dernière exploration, l’URL canonique retenue par Google, et les éventuels problèmes détectés (redirection, blocage par le fichier robots.txt, erreur serveur). C’est précis, lisible, et suffisant pour vérifier ponctuellement une poignée de pages stratégiques après une modification.
Sa limite est structurelle : l’outil n’est pas prévu pour un usage en masse. Il n’existe pas de mode d’exportation groupée depuis cette fonctionnalité, et la navigation reste manuelle, une URL après l’autre. Sur un catalogue produit ou un site éditorial de grande taille, cette approche devient rapidement impraticable, même en y consacrant une journée entière.
Ce que permet l’URL Inspection API
L’URL Inspection API, disponible depuis 2022 dans le cadre de l’API Search Console, expose la méthode urlInspection.index.inspect, qui accepte une URL et une propriété Search Console associée, et renvoie une structure JSON équivalente à celle affichée dans l’interface. Elle peut être appelée depuis un script, ce qui permet de boucler sur une liste complète d’URL issues d’un export de base de données ou d’un sitemap.
| Critère | Vérification manuelle | URL Inspection API |
|---|---|---|
| Volume traitable par jour | Quelques dizaines, en pratique | Jusqu’à 2 000 requêtes par propriété |
| Traçabilité des résultats | Aucune, sauf capture manuelle | Export structuré, historisable |
| Effort de mise en place | Nul | Authentification OAuth et script à écrire |
| Adapté à un audit ponctuel de 5 URL | Oui | Disproportionné |
| Adapté à un audit de 3 000 URL après refonte | Non réaliste | Oui, sur plusieurs jours |
La limite du quota, incontournable
Le quota de 2 000 requêtes par jour et par propriété reste la contrainte majeure de l’API : sur un catalogue de dix mille URL, un audit complet s’étale sur plusieurs jours, qu’il faut planifier avec une file d’attente et une reprise sur erreur. Un script minimal en PHP, s’appuyant sur la bibliothèque cliente officielle de Google, illustre cette contrainte :
$client = new Google_Client();
$client->setAuthConfig( 'credentials.json' );
$client->addScope( 'https://www.googleapis.com/auth/webmasters.readonly' );
$service = new Google_Service_SearchConsole( $client );
foreach ( $urls_a_verifier as $url ) {
$request = new Google_Service_SearchConsole_InspectUrlIndexRequest();
$request->setInspectionUrl( $url );
$request->setSiteUrl( 'https://exemple.fr/' );
$result = $service->urlInspection_index->inspect( $request );
// stocker $result->getInspectionResult() pour analyse
sleep( 1 ); // ménager le quota
}Un compromis possible
Sur les sites de taille moyenne, une approche hybride fonctionne bien : automatiser l’audit des URL à fort enjeu (pages catégories, pages produits vedettes) via l’API, et réserver la vérification manuelle aux cas litigieux identifiés par le script, où l’inspection visuelle dans l’interface apporte un contexte que le JSON brut ne donne pas toujours aussi clairement.
Notre verdict
Le choix ne devrait jamais être une question de préférence d’outil mais de volume à traiter. En dessous d’une trentaine d’URL à contrôler ponctuellement, l’interface manuelle reste plus rapide à mettre en œuvre qu’un script d’authentification OAuth. Au-delà, et surtout dans un contexte récurrent comme un contrôle mensuel après chaque publication en masse, l’URL Inspection API devient la seule option tenable, à condition d’accepter sa contrainte de quota et de construire un mécanisme de reprise capable d’étaler l’audit sur plusieurs jours sans perdre la progression déjà accomplie.
