Recevez les AI Overviews de Google en Markdown

Lisez les AI Overviews dans aioverview.markdown avec les titres, listes et tableaux mis en page par Google.

Ce qui change

• aioverview.markdown : l’AI Overview en Markdown, avec ses titres, listes, tableaux et passages en gras à leur place.
• aioverview.text reste identique et contient les mêmes mots : le code qui lit le texte brut continue de fonctionner.
• Les réponses de Google AI Mode contiennent le même Markdown dans markdown, pour chaque résultat.

Fonctionnement

Google structure un AI Overview avec des titres, des étapes numérotées, des listes et des tableaux comparatifs. aioverview.text garde les mots, et aioverview.markdown conserve aussi la structure : vous affichez l’aperçu tel que le voient les internautes, ou vous lisez sa structure dans votre code. Les pages citées restent dans aioverview.sources.

Activez-le avec include.aioverview.markdown: true. L’option commune include.markdown: true, déjà lue par les autres moteurs, l’active aussi.

Cas d’usage

• Affichez les AI Overviews dans vos tableaux de bord et rapports avec leur mise en forme d’origine.
• Repérez les marques que Google cite dans les étapes, tableaux et comparaisons d’un aperçu.
• Découpez un aperçu en sections pour voir les sujets que Google traite en premier.

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 robot vacuum for pet hair",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

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.

Réponse

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

{
  "success": true,
  "task": {
    "id": "8dcde5b1-2f53-40b3-b048-05075b03c4a9",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.237Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.",
      "markdown": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.\n\n### Top Robot Vacuums for Pet Hair\n\n**Roborock Saros Z70**\n\nNamed a top overall pick by experts for its strong hard-floor pickup, smart obstacle recognition, and self-emptying dock. It costs around $1,000.\n\n**MOVA V50**\n\nPraised as a top performer in dog hair tests and obstacle avoidance. It features a dual brush roller and app controls for auto-emptying frequency, usually priced under $700.\n\n…",
      "sources": [
        {
          "position": 2,
          "url": "https://www.rtings.com/robot-vacuum/reviews/best/pet-hair",
          "label": "RTINGS.com"
        },
        {
          "position": 3,
          "url": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-robot-vacuum-for-pet-hair/",
          "label": "Forbes Vetted"
        }
      ]
    }
  }
}

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

L’overview en Markdown, dans la structure affichée par Google : titres ###, listes, tableaux et gras.

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

Le tarif reste de 2 crédits par tâche terminée, Markdown compris.