API Google AI Overviews : texte de l'aperçu, sources et SERP

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.

Requête

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.

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 :

{
  "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.
`analysis`	Ajoute `analysis`, 1 crédit. Consultez Analyse de la réponse.
`citationAnalysis`	Lance une Citation Analysis sur l’aperçu.

searchQueries, ads et shopping n’ont aucun effet. Consultez Réponses Markdown et brutes. Pour les résultats organiques sans l’aperçu, plus vite et pour 1 crédit, utilisez Google Search.

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.

Premiers pas

Concepts clés

Moteurs de réponse

Recherche et données web

Options de requête

Analyses

Suivi GEO

Compte et données

API Google AI Overviews : texte de l'aperçu, sources et SERP

Requête

Réponse

`aioverview`

Flags include

Chine

Voir aussi

​Requête

​Réponse

​aioverview

​Flags include

​Chine

​Voir aussi

Requête

Réponse

`aioverview`

Flags include

Chine

Voir aussi