API ChatGPT : réponses, sources et requêtes de recherche

CHATGPT interroge ChatGPT avec la recherche web et renvoie la réponse, chaque source trouvée, les recherches lancées et les fiches de produits et de lieux affichées.


taskType	`CHATGPT`
Lit	`prompt` (se rabat sur `query`)
Crédits	1 par réponse
Pays	Facultatif, `US` par défaut. `CN` et `HK` sont interrogés depuis une sortie à Singapour avec une localisation d’appareil locale.
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": "CHATGPT", "payload": { "prompt": "best CRM for a small team", "country": "US" } }'

Réponse

Champ	Type	Description
`text`	string	La réponse en texte brut.
`markdown`	string	La réponse en Markdown, chaque photo à la place de sa carte. Activé par défaut.
`model`	string	Le modèle avec lequel ChatGPT a répondu.
`sources`	array	Chaque source : `position`, `url`, `label`, `footnote`, `datePublished`, `searchQueries`, `cited`, `citedText`.
`searchQueries`	string[]	Les recherches web lancées par ChatGPT. Activé par défaut.
`shoppingCards`, `inlineProducts`	array	Fiches produit et noms de produit liés dans la réponse. Activé par défaut (`include.shopping`).
`ads`	array	Éléments sponsorisés de la réponse. Activé par défaut (`include.ads`).
`entities`	array	Lieux et produits nommés dans les cartes, chacun avec son `type`, comme `local_business` ou `product`, et son `name`.
`entityDetails`	array	Le panneau de détail de chaque carte. Uniquement avec `include.entityDetails`. Consultez Détails des cartes.
`map`	array	Lieux affichés dans les cartes : adresse, coordonnées, téléphone, note et l’emoji `icon` avec lequel ChatGPT les épingle. `provider` est le flux d’où vient la fiche (`serp` et `bright-feed` pour Google Maps, `yelp-feed` pour Yelp, `tripadvisor-feed` pour Tripadvisor) ; `placeId` et `providerUrl` sont l’identifiant et la page du lieu dans ce flux. `resolvedBy: "address"` marque un lieu que ChatGPT a trouvé par l’adresse écrite par le modèle. `localName` est l’autre nom de la fiche, comme le nom coréen d’un commerce en Corée, et `closed` vaut `permanently` ou `temporarily`.
`citationPills`	array	Les sources derrière chaque pastille de citation en ligne.
`layout`	object	La disposition en cartes, quand ChatGPT présente la réponse sous forme de cartes. Voir plus bas.
`forms`	array	Les formulaires de suivi de la réponse, s’il y en a. Consultez Conversations.
`conversation`	object	`id`, `turn` et `expiresAt` de la conversation à laquelle appartient la réponse.
`html`	object	L’écran affiché par ChatGPT. Uniquement avec `include.html`.
`rawResponse`	array	Événements de flux analysés. Uniquement avec `include.rawResponse`.

Par exemple, une réponse abrégée :

{
  "text": "For a small team, HubSpot CRM and Pipedrive are the usual picks ...",
  "markdown": "For a small team, **HubSpot CRM** and **Pipedrive** are the usual picks ...",
  "model": "gpt-5-3",
  "sources": [
    {
      "position": 1,
      "url": "https://www.example.com/best-crm-small-business",
      "label": "The best CRM software for small businesses",
      "searchQueries": ["best CRM for small teams"],
      "cited": true,
      "citedText": ["HubSpot CRM and Pipedrive are the usual picks"]
    }
  ],
  "searchQueries": ["best CRM for small teams"],
  "conversation": { "id": "8f6c1d2e-...", "turn": 1, "expiresAt": "2026-10-19T12:00:00.000Z" }
}

Chaque source porte searchQueries (les recherches dont les résultats l’incluaient), cited (si la réponse la cite dans le texte) et citedText (le passage de la réponse que chaque citation appuie). Les sources qu’aucune recherche n’a renvoyées, comme les produits, n’ont pas de searchQueries.

Disposition en cartes

layout apparaît quand ChatGPT présente la réponse sous forme de cartes. Ses nodes suivent l’ordre affiché par ChatGPT :

Nœud	Contient
`row`, `box`	Des groupes de cartes.
`title`, `text`, `badge`	Le texte des cartes.
`image`	La photo : `images[].url`, `thumbnailUrl` et `pageUrl`.
`markdown`	Le reste de la réponse.
`map`	Dans `places`, la `position` de chaque lieu affiché.
`form`	Un formulaire qui vous demande de choisir une question de suivi. Ses nœuds `choice` portent les options et celle choisie au départ ; son nœud `button` porte la question que ChatGPT enverrait ensuite (`prompt`). Les formulaires sont exclus de `text` et `markdown`.

Flags include

CHATGPT respecte tous les flags de réponse. Tous sont activés par défaut sauf rawResponse et html ; envoyez false pour en désactiver un.

Flag	Défaut	Effet
`markdown`	`true`	Ajoute `markdown`.
`searchQueries`	`true`	Ajoute `searchQueries`.
`shopping`	`true`	Ajoute les fiches produit.
`ads`	`true`	Ajoute `ads`.
`rawResponse`	`false`	Ajoute `rawResponse`. Consultez Réponses Markdown et brutes.
`html`	`false`	Ajoute `html`, 0,25 crédit quand la page est enregistrée. Refusé avec `422 EVIDENCE_UNSUPPORTED` avec `location`, `CN`, `HK` ou `continueFrom`. Consultez Pages HTML.
`analysis`	`false`	Ajoute `analysis`, 1 crédit. Consultez Analyse de la réponse.
`citationAnalysis`	`false`	Lance une Citation Analysis sur la réponse.
`entityDetails`	`false`	Ajoute `entityDetails` sans crédit supplémentaire. Consultez Détails des cartes.

Détails des cartes

Avec include.entityDetails, chaque carte de la réponse (un produit, un lieu, une app ou une marque) arrive avec le panneau de détail que ChatGPT ouvre quand le lecteur clique dessus : description, caractéristiques, avis et pages qui les appuient. Les panneaux citent leurs propres pages et montrent ainsi des sources absentes du texte de la réponse.

Champ	Description
`name`, `category`, `query`	La carte telle que la réponse l’affiche, son type (`product`, `local_business`, `software`, `organization`) et le nom sous lequel ChatGPT l’a recherchée.
`status`	`ok`, ou `failed` avec une `error`.
`markdown`	Le panneau en Markdown, avec les puces de citation écrites comme dans la réponse.
`sources`	Chaque page citée une fois, dans l’ordre de sa première citation : `position`, `url`, `label`, `site`, `description`.
`products`	La fiche d’achat en tête du panneau d’un produit : `title`, `price`, `merchant`, `rating`, `num_reviews`, `url` et `offers`, au format de `shoppingCards[].products`. Seulement quand le panneau en affiche une.
`images`	Les photos du panneau.
`complete`	`false` quand ChatGPT a arrêté d’écrire le panneau avant la fin. Le texte et les sources jusqu’à ce point sont inclus.

error vaut ENTITY_DETAIL_FAILED si la demande du panneau échoue, ENTITY_DETAIL_EMPTY si le panneau ne contient aucun texte et ENTITY_DETAIL_UNAVAILABLE si les données de conversation ou les identifiants du tour nécessaires sont absents. Les détails fonctionnent aussi avec payload.location, CN, HK, les réponses du chemin de repli et include.html. Un panneau que ChatGPT a déjà écrit revient en une seconde environ ; un panneau qu’il écrit à la demande prend de 10 à 30 secondes, avec jusqu’à 4 panneaux à la fois. Jusqu’à 20 cartes sont ouvertes par réponse. Les panneaux n’ajoutent aucun crédit, et chaque réponse de suivi reçoit ses propres panneaux.

"entityDetails": [
  {
    "name": "Brooks Adrenaline GTS 25",
    "category": "product",
    "query": "Brooks Adrenaline GTS 25",
    "status": "ok",
    "markdown": "## Brooks Adrenaline GTS 25\n\nThe **Brooks Adrenaline GTS 25** is a **stability road running shoe** ... ([Brooks Running](https://www.brooksrunning.com/...))\n\n### Key specifications\n\n| Feature | Details |\n| --- | --- |\n| Heel-to-toe drop | 10 mm |\n...",
    "sources": [
      { "position": 1, "url": "https://www.brooksrunning.com/...", "label": "Men's Adrenaline GTS 25 Running Shoes | Brooks Running", "site": "Brooks Running" },
      { "position": 2, "url": "https://www.rei.com/product/249691/...", "label": "Brooks Adrenaline GTS 25 Road-Running Shoes - Men's | REI Co-op", "site": "REI" }
    ],
    "images": ["https://images.openai.com/..."],
    "complete": true
  }
]

Questions de suivi

payload.followUps pose jusqu’à 4 questions de plus dans la même conversation après la première réponse, dans l’ordre. Chaque élément est l’un des suivants :

{ "prompt": "..." } : une question à vous.
{ "select": { "button": 0, "choices": { "budget": "Under $100" } } } : appuie sur le bouton d’un formulaire de suivi de la réponse précédente.

button compte les boutons de la réponse à partir de 0 ; par défaut, c’est le premier. choices choisit les options par le name de chaque nœud choice, ou sous forme de tableau dans l’ordre du formulaire ; un choix est la value ou le label d’une option, ou sa position à partir de 0. Les choix que vous ne faites pas gardent l’option présélectionnée par ChatGPT : { "select": {} } envoie donc le prompt propre au bouton.

{
  "taskType": "CHATGPT",
  "payload": {
    "prompt": "best CRM for a small team",
    "country": "US",
    "followUps": [{ "prompt": "Which of these has the best free plan?" }]
  }
}

Les champs de premier niveau restent ceux de la première réponse. followUps dans la réponse liste chaque réponse suivante avec la question envoyée (prompt), ce sur quoi un select a appuyé (selection : le label du bouton et la valeur de chaque choix) et les mêmes champs que la première réponse. Quand un select ne peut pas être appliqué, les questions de suivi restantes ne sont pas posées, et followUpsStopped indique l’index de la question de suivi, un code et un message :

Code	Signification
`NO_FOLLOW_UP_FORM`	La réponse précédente n’affichait aucun formulaire.
`BUTTON_NOT_FOUND`	Aucun bouton à cet index.
`CHOICE_NOT_FOUND`	Aucun choix portant ce nom.
`OPTION_NOT_FOUND`	Aucune option ne correspond au choix.
`PROMPT_UNAVAILABLE`	Le bouton n’avait aucune question à envoyer.

La tâche se termine quand même avec les réponses obtenues. Chaque réponse coûte 1 crédit : la tâche réserve des crédits pour chaque question de suivi et ne facture que les réponses qu’elle renvoie. include.analysis, include.citationAnalysis et include.html s’appliquent à la première réponse. Les autres moteurs refusent followUps avec 400 VALIDATION_ERROR.

Continuer une conversation plus tard

Pour lire une réponse avant de choisir la question suivante, envoyez une nouvelle tâche CHATGPT avec payload.continueFrom égal à l’id d’une tâche terminée, et soit un prompt, soit un select qui appuie sur un formulaire de la dernière réponse de cette tâche (mêmes règles que pour followUps).

{
  "taskType": "CHATGPT",
  "payload": {
    "continueFrom": "8f6c1d2e-...",
    "select": { "button": 0 }
  }
}

Une réponse qui affiche un formulaire contient forms : les buttons de chaque formulaire, dont l’ordre est select.button, et ses choices avec leur name, l’option sélectionnée au départ et les options.
conversation.id est la tâche qui a ouvert la conversation, turn compte ses réponses jusqu’ici et expiresAt est le dernier moment pour la continuer, 3 heures après sa première réponse.
Une continuation pose la question sous la dernière réponse de la tâche que vous nommez : nommer deux fois la même tâche crée donc une branche dans la conversation.
Elle conserve le country et la location d’origine. Omettez-les ou envoyez les mêmes valeurs.
Une tâche d’un autre compte ou d’un autre moteur, une tâche non terminée ou un select invalide est refusé avec 400 VALIDATION_ERROR. Une conversation expirée est refusée avec 400 CONVERSATION_EXPIRED. Aucun des deux n’est facturé.
Une continuation coûte le même prix que toute tâche ChatGPT.

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 ChatGPT : réponses, sources et requêtes de recherche

Requête

Réponse

Disposition en cartes

Flags include

Détails des cartes

Questions de suivi

Continuer une conversation plus tard

Voir aussi

​Requête

​Réponse

​Disposition en cartes

​Flags include

​Détails des cartes

​Questions de suivi

​Continuer une conversation plus tard

​Voir aussi

Requête

Réponse

Disposition en cartes

Flags include

Détails des cartes

Questions de suivi

Continuer une conversation plus tard

Voir aussi