> ## 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 Google AI Overviews : texte de l'aperçu, sources et SERP

> Lancez une recherche Google et recevez l'AI Overview avec ses sources, ses produits et ses pastilles de citation, ainsi que la page de résultats qui l'entoure.

`GOOGLE` lance une recherche sur google.com et renvoie l'AI Overview avec la page de résultats de recherche où il apparaît.

| | |
| - | - |
| taskType | `GOOGLE` |
| Alias | `GOOGLE_AIO` |
| Lit | `query` (se rabat sur `prompt`) |
| Crédits | 1,25 |
| Pays | Facultatif, `US` par défaut. `CN` interroge le marché américain de Google depuis un appareil situé à Pékin. |
| Localisation | Accepte `payload.location`. Consultez [Régions et localisation](/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", "payload": { "query": "best CRM for a small team", "country": "US" } }'
```

## Réponse

La réponse est une enveloppe de résultats de recherche qui porte l'AI Overview comme un membre nullable, `aioverview`.

> [!WARNING]
>
> `aioverview: null` signifie que **Google n'a pas affiché d'AI Overview** pour cette requête. Ce n'est pas une erreur : la tâche se termine, et les champs de résultats autour restent renseignés.

| Champ | Type | Description |
| - | - | - |
| `aioverview` | object ou `null` | L'AI Overview. Champs ci-dessous. |
| `organicResults` | array | Résultats organiques. |
| `peopleAlsoAsk` | array | Le panneau « Autres questions posées ». |
| `relatedSearches` | array | Recherches associées. |
| `knowledgeGraph` | object | Le panneau de connaissances. |
| `ads` | array | Annonces en haut et en bas de page. |
| `map` | array | Le pack local : `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews`, `category`, `price`, `snippet`, `image`. |
| `serp` | object | Autres panneaux : `topStories`, `videoResults`, `localMap`, `discussionsAndForums`. |
| `rawContent` | string | Le HTML de la page de résultats rendue. Uniquement avec `include.rawResponse`. |
| `text`, `sources` | | Copies obsolètes de `aioverview.text` et `aioverview.sources`. Lisez `aioverview.*` dans le nouveau code. |

Les panneaux de résultats sont **omis** quand la page n'en contient pas, jamais émis comme `null` ou `[]`. Traitez-les tous comme facultatifs.

### `aioverview`

| Champ | Type | Description |
| - | - | - |
| `text` | string | Le texte de l'aperçu. Les titres des fiches produit y sont conservés. |
| `sources` | array | `position`, `url`, `label` et `description`. |
| `markdown` | string | L'aperçu en Markdown. Uniquement avec `include.markdown` ou `include.aioverview.markdown`. |
| `shoppingCards` | array | Vignettes produit à côté de la réponse : `title`, `position`, `price`, `oldPrice`, `store`, `rating`, `reviews`, `thumbnail`, `productLink`. |
| `inlineProducts` | array | Noms de produit liés dans la réponse : `title`, `position`, `productLink`. |
| `citationPills` | array | Une entrée par source derrière chaque pastille de citation. |
| `videos` | array | Vidéos affichées par l'aperçu : `title`, `link`, `platform`, `channel`, `duration`. |
| `sponsored` | array | Éléments sponsorisés dans l'aperçu : `label`, `title`, `advertiser`. |

Les champs de produits, de pastilles, de vidéos et d'éléments sponsorisés n'apparaissent que lorsque l'aperçu les affiche. `price.currency` est le symbole tel qu'affiché (`$`, `€`), `reviews` garde l'abréviation de Google (`2.3K`) et `productLink` est la page produit de Google.

Dans `citationPills`, les sources d'une même pastille partagent un `citationPillId`, numéroté dans l'ordre de la réponse, et `position` renvoie à l'entrée correspondante de `aioverview.sources`. Une page que seule une pastille cite figure aussi dans `aioverview.sources`, après les pages que l'aperçu liste, et son `label` est vide quand Google n'affiche pas de titre. Chaque entrée porte `label`, `url`, `domain` et, quand Google les affiche, `site`, `description` et `thumbnail`. Quand la réponse contient `markdown`, `markdownOffset` donne la place de la pastille dans ce texte ; les entrées `sponsored` portent de la même façon `labelOffset`, `markdownOffset` et `noteOffset`.

Par exemple :

```json theme={"theme":"css-variables"}
{
  "aioverview": {
    "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
    "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }],
    "citationPills": [
      { "label": "CRM guide for small teams", "citationPillId": 1, "url": "https://www.example.com/crm-guide", "domain": "example.com", "position": 1 }
    ]
  },
  "organicResults": [
    { "position": 1, "title": "The best CRM for small teams", "link": "https://www.example.com/crm-guide", "snippet": "..." }
  ],
  "relatedSearches": [{ "query": "free crm for small team" }],
  "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
  "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }]
}
```

## Flags include

| Flag | Effet |
| - | - |
| `markdown` | Ajoute `aioverview.markdown`. `include.aioverview.markdown` fait de même. |
| `rawResponse` | Ajoute `rawContent`, la page de résultats rendue. |
| `html` | Ajoute `html`, la page de résultats sous forme de fichier partageable. Consultez [Pages HTML](/fr/engines/html-pages.md). |
| `analysis` | Ajoute `analysis`, 1 crédit. Consultez [Analyse de la réponse](/fr/engines/answer-analysis.md). |
| `citationAnalysis` | Lance une [Citation Analysis](/fr/research/citation-analysis.md) sur l'aperçu. |

`searchQueries`, `ads` et `shopping` n'ont aucun effet. Consultez [Réponses Markdown et brutes](/fr/engines/response-options.md). Pour les résultats organiques sans l'aperçu, plus vite et pour 1 crédit, utilisez [Google Search](/fr/engines/google-serp.md).

## Chine

Google n'affiche pas d'AI Overview sur le marché chinois. Une tâche `CN` interroge donc le marché américain de Google (`gl=us`) depuis un appareil situé à Pékin, comme le font les internautes de Chine continentale pour accéder à Google. Une tâche qui porte son propre `payload.location` utilise plutôt cette localisation.

## Voir aussi

* [Page produit Google AI Overviews](https://querying.ai/fr/engines/google-ai-overviews)
* [Google AI Mode](/fr/engines/google-ai-mode.md)
* [Vue d'ensemble des moteurs](/fr/engines/overview.md)


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