Web Search Service : la documentation de l’API partenaires de Google renvoie une 404

L’essentiel

• L’URL developers.google.com/web-search-service/overview renvoie une erreur 404, sans redirection.
• Selon Manas Panda, la page est apparue vers le 22 août et a disparu le 20 septembre 2026.
• Elle décrivait une API de résultats web réservée à des « partenaires programmatiques ».
• Google n’a donné aucune explication sur ce retrait.

Une page retirée un dimanche, sans redirection ni avis

La disparition a été signalée par Manas Panda dans un post LinkedIn. Son équipe passe chaque jour en revue les pages de développeurs de Google et publie un journal daté de ces relevés. Le dernier accès réussi y figure le 19 septembre à 22 h 15 (heure indienne), la première erreur 404 le 20 septembre à 22 h 15. Entre les deux, la Wayback Machine a enregistré une dernière copie le 20 septembre à 10 h 09 (UTC). D’après Manas Panda, la page a donc disparu dans une fenêtre d’environ sept heures, un dimanche après-midi.

Il insiste sur la forme du retrait : la page n’a pas été dépréciée, elle a été « supprimée : une 404 franche, sans redirection ni mention » (traduction). Le 24 septembre, l’erreur était toujours là. Barry Schwartz a repris l’information le 28 septembre sur Search Engine Roundtable, en s’appuyant sur la copie archivée. L’URL de la documentation répond bien par une 404.

Publiée fin août, mise à jour le 9 septembre

Search Engine Journal avait décrit cette documentation le 11 septembre, sous la plume de Matt G. Southern. Selon lui, Google avait actualisé le 9 septembre la page de présentation et quatre pages associées. La date du 22 août avancée par Manas Panda correspond à une première mise en ligne, antérieure à cette révision. Les deux versions sont compatibles : une page publiée fin août, revue le 9 septembre, puis retirée onze jours plus tard. Seul le relevé de Manas Panda documente toutefois la date de première publication.

Ce que décrivait la documentation

D’après la copie archivée citée par Search Engine Roundtable, l’API servait aux « partenaires programmatiques » (traduction) pour développer des sites et des applications. Les résultats de recherche étaient récupérés au format JSON, via des requêtes REST ou gRPC. Search Engine Journal détaillait une méthode unique, Search, présentée dans la référence comme une « recherche web complète » (traduction). Chaque requête devait contenir un identifiant client lié à un accord de partenariat, l’adresse IP de l’internaute et la requête elle-même, en plus d’un projet Google Cloud et d’une clé d’API.

La réponse comptait 10 résultats par défaut, 20 au maximum, et un jeton de pagination permettait d’aller plus loin. Les filtres portaient sur la langue, le pays, la période et SafeSearch, avec un tri possible par date. Pour chaque résultat : titre, URL, extrait, type MIME et format de fichier. S’y ajoutaient un nombre total estimé de résultats et, le cas échéant, une requête corrigée. La documentation ne disait rien des conditions pour devenir partenaire, du prix ou des quotas. Manas Panda évoque de son côté une offre payante, sans que ce point soit étayé ailleurs.

Qui y a accès : des hypothèses, aucune confirmation

Barry Schwartz rappelle que Google ne propose aucune API publique de ce type. Il suppose que des partenaires comme Apple y ont accès, sans citer de source. Pour lui, Google semble avoir publié la page par erreur, et la documentation n’avait guère d’utilité : les partenaires concernés disposent déjà de la leur. Google ne s’est exprimé ni sur la publication ni sur le retrait.

Le calendrier rend le sujet sensible. La Custom Search JSON API n’accepte plus de nouveaux clients et sera arrêtée le 1er janvier 2027 pour ceux qui interrogent plus de 50 domaines ou le web entier. En janvier, Google avait orienté ces utilisateurs vers une solution distincte, destinée à « ceux qui ont besoin de tout notre index » (traduction), avec un formulaire d’intérêt mais sans prix ni détail. Search Engine Journal relevait que Web Search Service correspond à ce besoin. Aucun document de Google ne fait pourtant le lien entre les deux.

Ce que j’en retiens

Une page retirée ne signifie pas un service arrêté. Je partage l’hypothèse de Barry Schwartz, sans pouvoir la confirmer : la documentation a sans doute été rendue publique par erreur, puis retirée faute d’offre ouverte à tous. Si vous utilisez encore la Custom Search JSON API sur tout le web, ne bâtissez pas votre migration sur Web Search Service. Mieux vaut remplir le formulaire d’intérêt de Google et prévoir une solution de repli avant le 1er janvier 2027.

Si un outil ou un processus interne repose sur une page de documentation Google, archivez-en une copie datée. Celle-ci a disparu en quelques heures.