Passer au contenu principal
GOOGLE_NEWS renvoie les articles que Google affiche dans son onglet Actualités pour une recherche. Il lit jusqu’à dix pages d’environ 10 articles et conserve l’ordre de Google d’une page à l’autre : vous suivez quels médias Google affiche pour un sujet, une marque ou un concurrent, et comment cela évolue dans le temps.

Requête

Cette requête demande les deux premières pages d’Actualités sur les droits de douane sur les véhicules électriques aux États-Unis :
La tâche s’exécute de façon asynchrone. Lisez le résultat comme décrit dans Tâches asynchrones.

Paramètres

Réponse

Par exemple, la requête ci-dessus :
Quand la liste de Google s’arrête avant pages, newsResults contient tous les articles affichés par Google et pages compte les pages lues. Traitez tous les champs sauf position, title, link et page comme facultatifs.

Crédits

Chaque page d’Actualités lue coûte 1 crédit. À son démarrage, la tâche bloque les crédits des pages demandées : 1 par défaut, 10 avec pages: 10. À la fin, elle est facturée pour les pages lues : une liste que Google arrête après trois pages coûte 3. Une tâche échouée coûte 0. Voir Crédits et limites.

Limites et erreurs

  • Un newsResults vide dans une tâche terminée signifie que Google n’a affiché aucun article pour la recherche. C’est confirmé sur un second navigateur avant d’être renvoyé, et cela coûte 1 crédit.
  • Un hl qui n’est pas un code de langue comme en, de ou pt-BR renvoie 422 VALIDATION_ERROR.
  • Un pages hors de 1-10 ou un device autre que desktop, mobile ou android renvoie 422 VALIDATION_ERROR.
  • state et uule renvoient 422 LOCATION_UNSUPPORTED. Fixez le marché avec country.
  • include.rawResponse est sans effet, et include.html et include.analysis renvoient 422. Voir Markdown et réponses brutes.
  • Les autres erreurs de requête sont listées dans Erreurs.

Voir aussi