Comment exploiter l'API URL Inspection pour détecter les écarts entre canonical déclaré et canonical Google ?

Pourquoi Google expose-t-il deux canonicals différents dans son API ?

Google a toujours eu le dernier mot sur le choix de la canonical. Vous pouvez déclarer une URL canonique via la balise rel="canonical", les en-têtes HTTP ou le sitemap, mais Google n'est pas obligé de la respecter.

L'API URL Inspection formalise cette distinction en renvoyant deux champs : user-declared canonical (ce que vous avez indiqué) et Google-selected canonical (ce que Google a effectivement retenu). Avant, il fallait croiser plusieurs rapports pour détecter ces écarts — maintenant c'est exposé directement.

Dans quels cas ces deux valeurs divergent-elles ?

Les divergences surviennent quand Google détecte des signaux contradictoires ou juge votre déclaration peu fiable. Par exemple : contenus quasi-identiques sans balise canonical cohérente, redirections en chaîne, paramètres d'URL mal gérés, ou variations mobiles vs desktop mal configurées.

Google peut aussi ignorer votre canonical si l'URL que vous désignez renvoie une erreur 4xx/5xx, ou si elle n'est pas indexable (robots.txt, noindex). Dans ces cas, il choisira une autre URL de la série comme canonical — souvent celle qu'il juge la plus pertinente pour l'utilisateur.

Quels sont les points essentiels à retenir ?

• L'API URL Inspection expose deux champs distincts pour les canonicals : celui que vous déclarez et celui que Google retient.
• Un écart entre ces deux valeurs signale un problème d'indexation potentiel ou une divergence de compréhension entre votre intention et l'analyse de Google.
• Cette fonctionnalité permet d'automatiser la détection de ces divergences à l'échelle, via un script ou un outil tiers qui interroge l'API.
• Google ne respecte jamais aveuglément votre canonical — il applique ses propres règles de consolidation d'URL.

Cette API change-t-elle vraiment la donne pour le diagnostic technique ?

Oui, pour deux raisons. D'abord, elle automatise un processus pénible : avant, il fallait comparer manuellement les rapports de couverture, les sitemaps et les logs serveur pour repérer ces divergences. Maintenant, un script Python peut interroger l'API sur 10 000 URLs et te sortir un CSV des écarts en quelques minutes.

Ensuite, elle force Google à être transparent sur un point qu'il esquivait souvent : la différence entre ce que le SEO déclare et ce que le crawler retient réellement. Ça met fin aux débats stériles du type « mais j'ai bien mis la canonical, pourquoi Google indexe l'autre URL ? ».

Quelles nuances faut-il apporter ?

L'API ne t'explique pas pourquoi Google a choisi une canonical différente de la tienne. Tu vois l'écart, mais pas la cause. C'est à toi de croiser avec les logs, les redirections, les signaux hreflang, etc.

Autre limite : l'API URL Inspection a un quota restrictif (600 requêtes/minute pour un projet standard). Pour un audit d'un gros site, tu vas devoir rogner les URL testées ou étaler les requêtes. [À vérifier] : certains outils SEO tiers prétendent contourner cette limite via des clés API multiples, mais ça reste flou côté Google.

Dans quels cas cette divergence n'est-elle pas un problème ?

Parfois, Google choisit une canonical différente pour de bonnes raisons. Par exemple, si tu as une version AMP et une version classique, et que tu as mal déclaré les canonicals, Google peut rectifier de lui-même en retenant la version la plus pertinente pour l'utilisateur.

De même, sur les sites e-commerce avec des variantes produit (couleur, taille), Google peut décider qu'une URL variante mérite d'être indexée séparément si elle apporte du contenu unique (avis clients, images différentes). Dans ce cas, l'écart canonical n'est pas une anomalie — c'est une décision éditoriale de Google.

Comment exploiter concrètement cette API pour auditer un site ?

Monte un script (Python + Google Search Console API) qui interroge l'API URL Inspection sur un échantillon d'URLs stratégiques : pages catégories, fiches produit à fort trafic, pages de contenu éditorial. Compare les deux champs canonical et génère un rapport des divergences.

Si tu n'es pas développeur, des outils comme Screaming Frog ou OnCrawl intègrent déjà cette fonctionnalité via l'API. Configure une crawl hebdomadaire qui vérifie automatiquement les écarts canonical et t'alerte en cas de dérive.

Quelles erreurs éviter lors de l'analyse des divergences ?

Ne panique pas si 5-10% de tes URLs montrent un écart. C'est courant sur les gros sites avec historique complexe. Concentre-toi sur les URLs à fort enjeu business : celles qui génèrent du trafic ou des conversions.

Évite aussi de corriger les canonicals sans croiser avec les données de trafic. Parfois, Google a raison : l'URL qu'il a choisie performe mieux que celle que tu avais désignée. Vérifie dans Analytics ou la Search Console les métriques de chaque URL avant de toucher quoi que ce soit.

Checklist : que vérifier en priorité ?

• Interroger l'API sur un échantillon représentatif d'URLs (au moins 500-1000 pour un site moyen)
• Identifier les écarts canonical et les trier par volume de trafic décroissant
• Croiser avec les logs serveur pour voir si Google crawle massivement les URLs non-canonical
• Vérifier les balises rel="canonical" et les en-têtes HTTP sur les pages concernées
• Contrôler les redirections 301/302 : une chaîne de redirections peut perturber le choix de la canonical
• Analyser les signaux hreflang : une erreur de déclaration peut pousser Google à ignorer ta canonical
• Mesurer l'impact trafic : si l'URL choisie par Google performe mieux, laisser tel quel