Les AI Overviews de Google sont désormais pris en charge

Envoyez une requête et recevez l’AI Overview de Google avec ses pages citées, ainsi que les résultats naturels, les questions associées et les recherches associées de la même page.

Ce que vous obtenez

• aioverview.text et aioverview.sources : l’AI Overview et les pages qu’il cite.
• organicResults : les résultats classiques de la même page, avec position, titre, lien et extrait.
• peopleAlsoAsk, relatedSearches, knowledgeGraph et ads dès que Google les affiche.

Fonctionnement

Chaque tâche lance votre requête sur Google depuis le pays choisi et lit toute la page de résultats. Google décide à chaque recherche s’il affiche un AI Overview, et chaque résultat terminé indique s’il est apparu : il arrive dans aioverview, qui vaut null sur une page composée uniquement de résultats naturels.

Cet indicateur devient une mesure. Sur un ensemble de mots-clés, la part des requêtes avec un AI Overview donne votre couverture, et les overviews eux-mêmes montrent les marques et les pages que Google met en avant.

Cas d’usage

• Mesurez combien de vos mots-clés cibles déclenchent un AI Overview, marché par marché.
• Voyez si vos pages sont citées dans l’overview ou classées dans les résultats naturels en dessous.
• Puisez de nouveaux prompts à suivre dans les questions et recherches associées.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête Authorization.

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 wireless earbuds for commuting",
      "country": "US"
    }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.querystringObligatoire

La requête, rédigée comme un utilisateur la tape dans le champ de recherche.

payload.countrystring

Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.

payload.include.markdownboolean

Avec true, l’aperçu arrive aussi en aioverview.markdown, avec ses titres, listes et tableaux, tel que Google l’affiche.

webhook.urlstring

Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

idempotencyKeystring

Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

{
  "success": true,
  "task": {
    "id": "310ab45d-209e-4a15-8379-9379ab041d48",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:53:21.022Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Anker Soundcore Space A40 is the best wireless earbud for commuting due to its strong adaptive noise cancellation, long battery life, and compact value.",
      "sources": [
        {
          "position": 1,
          "url": "https://www.soundcore.com/products/space-a40-a3936011",
          "label": "Anker Soundcore Space A40"
        },
        {
          "position": 2,
          "url": "https://www.techtimes.com/articles/313618/20260101/best-wireless-bluetooth-earbuds-under-100-are-they-really-worth-price.htm",
          "label": "Tech Times"
        }
      ],
      "shoppingCards": [
        {
          "position": 1,
          "title": "Anker Soundcore Space A40",
          "price": { "raw": "$54.99", "value": 54.99, "currency": "$" },
          "store": "soundcore US",
          "rating": 4.4,
          "reviews": "1.2K"
        }
      ]
    },
    "organicResults": [
      {
        "position": 1,
        "title": "Highest Rated Wireless Earbuds",
        "link": "https://www.amazon.com/Highest-Rated-Wireless-Earbuds/s?k=Highest+Rated+Wireless+Earbuds",
        "snippet": "Soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, Water-Resistant, 2 Mics for AI Clear Calls, ..."
      }
    ],
    "peopleAlsoAsk": [
      { "question": "What are the best wireless earbuds for office work?" }
    ],
    "relatedSearches": [
      { "query": "Best wireless earbuds for commuting reddit" },
      { "query": "Best wireless earbuds for commuting iphone" }
    ]
  }
}

task.statusstring

QUEUED, PROCESSING, puis COMPLETED avec la réponse ou FAILED avec error.

credits.creditsChargedinteger

Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.

response.aioverviewobject

L’AI Overview avec son text, ses sources et, sur demande, markdown. null signale une requête à laquelle Google répond par les seuls résultats de recherche.

response.aioverview.shoppingCardsarray

Fiches produits de l’overview : nom, prix, boutique, note, avis et lien.

response.organicResultsarray

Les résultats de recherche de la page : position, title, link, snippet et page.

response.peopleAlsoAskarray

Les questions associées affichées par Google sur la page.

response.relatedSearchesarray

Les recherches associées en bas de page.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Tarif

Chaque tâche terminée utilise 2 crédits.