Les cartes ChatGPT arrivent avec leur panneau de détail

Activez include.entityDetails sur une tâche ChatGPT et recevez sans frais le panneau que ChatGPT ouvre pour chaque carte de produit, de lieu ou de marque de la réponse, avec son texte, ses sources et ses images.

Ce que vous obtenez

• payload.include.entityDetails: true sur les tâches CHATGPT.
• entityDetails sur la réponse et sur chaque réponse de followUps : une entrée par carte citée dans la réponse, jusqu’à 20.
• Chaque entrée contient name, category (product, local_business, software, organization, brand et d’autres), query, status, markdown, sources, products, images et complete.
• sources liste les sites cités par le panneau, avec position, url, label, site et description.

Fonctionnement

Quand un utilisateur clique sur une carte de produit, de lieu ou de marque dans une réponse de ChatGPT, ChatGPT ouvre un panneau et en rédige une courte présentation en citant les sites qu’il a lus. Une fois la réponse terminée, ce même panneau est demandé pour chaque carte, dans la même conversation, quatre cartes à la fois. L’étape de détail ajoute environ 10 secondes à une réponse.

markdown est le panneau tel que ChatGPT l’a écrit, avec ses titres, listes et liens vers les sources. complete: false signifie que ChatGPT s’est arrêté avant la fin du panneau ; le texte et les sources écrits jusque-là sont conservés.

Chaque carte est traitée séparément. Une carte en échec porte status: "failed" et une error (ENTITY_DETAIL_FAILED ou ENTITY_DETAIL_EMPTY), et la réponse et les autres cartes se terminent normalement. Sur les tâches avec location, CN ou HK, les cartes reviennent avec ENTITY_DETAIL_UNAVAILABLE.

include.entityDetails fonctionne sur CHATGPT et s’utilise sans include.html. Envoyé à un autre moteur ou avec include.html, il renvoie 422 VALIDATION_ERROR avant toute réservation de crédits.

Cas d’usage

• Lisez comment ChatGPT présente votre produit quand un acheteur clique sur sa carte, et vérifiez les caractéristiques, prix et affirmations qu’il reprend.
• Voyez quels sites ChatGPT cite pour votre produit et pour chaque concurrent, et organisez avis et fiches autour de ces sites.
• Posez la même question dans plusieurs pays et comparez la façon dont le panneau de chaque marché présente la même marque.

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": "CHATGPT",
    "payload": {
      "prompt": "What is the best robot vacuum for pet hair?",
      "country": "US",
      "include": { "entityDetails": true }
    }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.promptstringObligatoire

La question, rédigée comme un utilisateur la tape dans le chat. Jusqu’à 100 000 caractères.

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

Avec true, entityDetails s’ajoute : le panneau de détail que ChatGPT ouvre pour chaque carte de la réponse. Sur CHATGPT, sans include.html. Désactivé par défaut, sans crédit en plus.

payload.followUpsarray

Jusqu’à 4 tours de plus dans la même conversation ChatGPT après la première réponse. Chaque élément est {"prompt": "…"} pour poser une question, ou {"select": {…}} pour appuyer sur un bouton du formulaire de la réponse précédente. Pour CHATGPT.

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": "a81e4b26-b4c0-48eb-b20b-10efbd327f1a",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T04:40:09.819Z"
  },
  "response": {
    "text": "For most pet owners, I’d start with the **Dreame L40 Ultra Gen 2**. It offers a strong mix of pet-hair pickup, anti-tangle features, automatic dust emptying, and minimal day-to-day maintenance without necessarily requiring a flagship-level budget. …",
    "model": "gpt-6",
    "entityDetails": [
      "…",
      {
        "name": "Roborock Saros 20",
        "category": "product",
        "query": "Roborock Saros 20",
        "status": "ok",
        "markdown": "The **Roborock Saros 20** is Roborock's 2026 flagship robot vacuum and mop. It focuses on high-end automation with powerful vacuuming, dual spinning mop pads, advanced obstacle avoidance, an ultra-slim body for cleaning under furniture, and a dock that automates most maintenance tasks. …",
        "sources": [],
        "images": [],
        "complete": true
      },
      {
        "name": "MOVA P50 Pro Ultra",
        "category": "product",
        "query": "MOVA P50 Pro Ultra",
        "status": "ok",
        "markdown": "## MOVA P50 Pro Ultra\n\nThe **MOVA P50 Pro Ultra** is a premium robot vacuum and mop introduced as MOVA's 2025 flagship model. … ([RTINGS.com +1](https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com))\n\n### Key features\n\n- **19,000 Pa suction power**\n- **Dual rotating mop pads**\n…",
        "sources": [
          {
            "position": 1,
            "url": "https://www.rtings.com/robot-vacuum/reviews/mova/p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
            "label": "MOVA P50 Pro Ultra Review - RTINGS.com",
            "site": "RTINGS.com"
          },
          {
            "position": 2,
            "url": "https://us.mova.tech/products/mova-p50-pro-ultra-robot-vacuum?utm_source=chatgpt.com",
            "label": "MOVA P50 Pro Ultra Robot Vacuum and Mop Combo | MOVA US",
            "site": "MOVA-US"
          },
          {
            "position": 3,
            "url": "https://www.idealhome.co.uk/house-manual/floorcare/mova-p50-pro-ultra-robot-vacuum-review?utm_source=chatgpt.com",
            "label": "I've spent years telling people that robot mops aren't worth the money - the MOVA P50 Pro Ultra is the first one to change my mind",
            "site": "Ideal Home",
            "description": "The review provides a detailed assessment of the MOVA P50 Pro Ultra Robot Vacuum, marking a pivotal shift in the author's long-standing skepticism toward robot mops. …"
          },
          "…"
        ],
        "images": [],
        "complete": true
      },
      "…"
    ]
  }
}

task.statusstring

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

response.textstring

La réponse en texte brut.

response.entityDetailsarray

Un panneau par carte, jusqu’à 20 : name, category, query, status (ok ou failed), markdown, sources, products, images et complete. Une carte en échec porte une error, et la réponse se termine normalement.

response.followUpsarray

Une réponse par relance, dans l’ordre. Chaque élément contient le prompt envoyé, selection (le bouton et les valeurs) pour un select, et les champs de la première réponse, comme text, markdown, sources, searchQueries et model.

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"

Erreurs

VALIDATION_ERRORHTTP 422

include.entityDetails a été envoyé à un moteur autre que CHATGPT, avec include.html ou avec une valeur non booléenne. details indique payload.include.entityDetails.

MISSING_API_KEYHTTP 401

L’en-tête Authorization manque, ou sa clé est inconnue, expirée ou révoquée.

INSUFFICIENT_CREDITSHTTP 402

Le solde est inférieur au prix de la tâche. Ajoutez des crédits ou changez de plan, puis renvoyez-la.

Tarif

Les détails de carte sont gratuits. Une tâche ChatGPT coûte le même prix avec ou sans include.entityDetails : 1 crédit par réponse, y compris chaque réponse de relance.