> ## 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 de recherche Google (GOOGLE_SERP)

> Obtenez une page de résultats organiques, d'annonces et de panneaux SERP google.com pour une requête, sans attendre d'AI Overview.

`GOOGLE_SERP` charge une page de résultats google.com et renvoie ses résultats organiques et ses panneaux. Il n'attend pas d'AI Overview : il répond donc plus vite que [`GOOGLE`](/fr/engines/google-ai-overviews) et coûte moins cher. Utilisez-le pour le suivi de positionnement, ou pour trouver des pages à lire avec [`WEB_SCRAPE`](/fr/engines/web-scrape).

| | |
| - | - |
| `taskType` | `GOOGLE_SERP` |
| Entrée | `query` (obligatoire) ; `page`, `country`, `location`, `include` |
| Crédits | 1 par tâche |
| Pays | `US` par défaut. Tout code ISO 3166-1 alpha-2. |
| Position | Prise en charge. Voir [Régions et position](/fr/engines/capacity.md). |

## Requête

```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_SERP", "payload": { "query": "best running shoes for flat feet", "country": "US", "page": 2 } }'
```

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

## Paramètres

| Champ | Obligatoire | Description |
| - | - | - |
| `query` | Oui | La requête de recherche, de 1 à 100 000 caractères. `prompt` est accepté si `query` est absent. |
| `page` | Non | Page de résultats, un entier de 1 à 10. `1` par défaut. Chaque page contient dix résultats organiques. Les autres valeurs renvoient `422 VALIDATION_ERROR`. |
| `country` | Non | Le marché Google à interroger. `US` par défaut. |
| `location` | Non | `{ "latitude", "longitude" }` en degrés décimaux. Google répond comme à un utilisateur situé à ce point, et le résultat le renvoie dans `location`. |
| `include.rawResponse` | Non | `true` ajoute le HTML de la page de résultats dans `rawContent`. La page est volumineuse, souvent près d'un mégaoctet. |

## Réponse

Par exemple, la page 2 d'une requête :

```json theme={"theme":"css-variables"}
{
  "organicResults": [
    { "position": 11, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "page": 2 }
  ],
  "peopleAlsoAsk": [{ "...": "..." }],
  "relatedSearches": [{ "...": "..." }],
  "ads": [{ "...": "..." }],
  "page": 2
}
```

| Champ | Description |
| - | - |
| `organicResults` | Toujours présent. `position` compte à travers les pages : le premier résultat de la page 2 est donc `11`. Chaque ligne porte la `page` dont elle provient. |
| `page` | La page chargée. |
| `peopleAlsoAsk`, `relatedSearches`, `knowledgeGraph` | Les panneaux de Google, quand la page les affiche. |
| `ads` | Les annonces du haut et du bas, quand la page en affiche. |
| `map` | Le pack local : des lieux avec `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews` et plus, quand la page en affiche un. |
| `serp` | Les autres panneaux présents : `topStories`, `videoResults`, `localMap`, `discussionsAndForums`. |
| `location` | Le point envoyé, si vous en avez envoyé un. |
| `rawContent` | Le HTML de la page de résultats, avec `include.rawResponse: true`. |

Les panneaux absents de la page sont omis, et non renvoyés comme `null` ou `[]`. Traitez tous les champs sauf `organicResults` et `page` comme facultatifs. Il n'y a ni `aioverview`, ni `text`, ni `sources` ; utilisez [`GOOGLE`](/fr/engines/google-ai-overviews) pour l'AI Overview.

## Limites et erreurs

* Un `organicResults` vide dans une tâche terminée signifie que Google lui-même n'a renvoyé aucun résultat pour la requête. C'est confirmé sur un second navigateur avant d'être renvoyé.
* Une `page` hors de 1-10 renvoie `422 VALIDATION_ERROR`.
* Une `location` mal formée renvoie `400 VALIDATION_ERROR`.
* Les autres erreurs de requête sont listées dans [Erreurs](/fr/concepts/errors.md).

## Voir aussi

* [Google AI Overviews](/fr/engines/google-ai-overviews.md) pour la même page avec son AI Overview
* [Web scrape](/fr/engines/web-scrape.md) pour lire la page d'un résultat en Markdown
* [Régions et position](/fr/engines/capacity.md)


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