> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API des résultats Google News

> Obtenez les articles que l'onglet Actualités de Google affiche pour une recherche, jusqu'à dix pages, avec média, date et lien.

`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.

| | |
| - | - |
| `taskType` | `GOOGLE_NEWS` |
| Entrée | `query` (obligatoire) ; `pages`, `country`, `device`, `hl` |
| Crédits | 1 par page d'Actualités lue. Une page contient environ 10 articles. |
| Pays | `US` par défaut. Tout code ISO 3166-1 alpha-2. |

## 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 :

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_NEWS", "payload": { "query": "electric vehicle tariffs", "country": "US", "pages": 2 } }'
```

La tâche s'exécute de façon asynchrone. Lisez le résultat comme décrit dans [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md).

## Paramètres

| Champ | Obligatoire | Description |
| - | - | - |
| `query` | Oui | La recherche, de 1 à 100 000 caractères. `prompt` est accepté si `query` est absent. |
| `pages` | Non | Le nombre de pages d'Actualités à lire, un entier de 1 à 10. `1` par défaut. |
| `country` | Non | Le marché Google à interroger. `US` par défaut. La langue de la page suit le pays, sauf si `hl` la fixe. |
| `device` | Non | `desktop` par défaut. `mobile` ou `android` lit la page que Chrome affiche sur un téléphone Android. `ios` renvoie `422`. |
| `hl` | Non | Le `hl` de Google, la langue de la page d'actualités. Par défaut, celle du `country`. Les dates et libellés des articles s'affichent dans cette langue. `pt-br` se lit `pt-BR`. |

## Réponse

Par exemple, la requête ci-dessus :

```json theme={"theme":"css-variables"}
{
  "newsResults": [
    {
      "position": 1,
      "title": "...",
      "link": "https://...",
      "snippet": "...",
      "source": "...",
      "date": "3 hours ago",
      "page": 1,
      "thumbnail": "..."
    },
    { "position": 11, "page": 2, "...": "..." }
  ],
  "pages": 2
}
```

| Champ | Description |
| - | - |
| `newsResults` | Toujours présent, dans l'ordre de Google. Chaque article porte `position`, `title`, `link` et `page`, ainsi que `snippet`, `source`, `date` et `thumbnail` quand Google les affiche. |
| `newsResults[].position` | Le rang de l'article dans toute la liste, à partir de 1. Il se poursuit d'une page à l'autre. |
| `newsResults[].page` | La page d'Actualités d'où provient l'article, de 1 à 10. |
| `newsResults[].link` | L'adresse de l'article. Vide quand la redirection de Google n'a pas été lue à temps ; la redirection est alors dans `redirectLink`. |
| `newsResults[].redirectLink` | La redirection de Google pour l'article, quand Google a servi le lien sous cette forme. Résolvez un `link` vide avec [`POST /v1/google/goto`](https://docs.querying.ai/fr/api-reference/google-goto). |
| `newsResults[].date` | L'ancienneté ou la date telle que Google l'affiche, dans la langue de la page. |
| `pages` | Le nombre de pages d'Actualités lues. La tâche est facturée pour ces pages. |

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](https://docs.querying.ai/fr/concepts/credits-and-limits.md).

## 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](https://docs.querying.ai/fr/engines/response-options.md).
* Les autres erreurs de requête sont listées dans [Erreurs](https://docs.querying.ai/fr/concepts/errors.md).

## Voir aussi

* [Google Search](https://docs.querying.ai/fr/engines/google-serp.md) pour une page de résultats avec ses résultats naturels
* [Résoudre une redirection Google](https://docs.querying.ai/fr/api-reference/google-goto.md)
* [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.