Recevez l’écran que chaque moteur d’IA a affiché avec sa réponse

Activez include.html sur ChatGPT, Gemini, Perplexity, Meta AI, Google AI Overviews ou AI Mode et recevez un lien vers l’écran de réponse du moteur lui-même, enregistré comme une page qui s’ouvre sans clé d’API.

Ce que vous obtenez

• payload.include.html: true sur CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE et AIMODE.
• html dans la réponse : status (ok ou failed), url et expiresAt. Le lien fonctionne 30 jours après la fin de la tâche.
• La page s’ouvre sans clé d’API et ne charge rien de l’extérieur : vous pouvez la partager en lien ou l’intégrer dans un rapport.
• Les champs de la réponse (text, sources et les autres) arrivent comme avant. Une page en échec ne fait jamais échouer la tâche.

Fonctionnement

Sur ChatGPT, Gemini, Perplexity et Meta AI, la question est posée dans un vrai navigateur sur le site du moteur, et l’écran est enregistré quand la réponse se termine : la barre latérale, la question, la réponse avec ses sources et la zone de saisie. Les champs de la réponse viennent de cette même question, et un écran qui ne correspond pas à la réponse n’est pas enregistré.

Les scripts sont retirés avant l’enregistrement, et les images, styles et polices sont placés dans le fichier. La page s’ouvre de la même façon dans n’importe quel navigateur, sans rien charger depuis le moteur.

Sur Google AI Overviews et AI Mode, la page est la page de résultats que Google a renvoyée pour la tâche, sans ses scripts. L’AI Overview et sa liste de sources sont enregistrés ouverts, comme après un clic sur Plus et Tout afficher, pour que la réponse entière se lise sans scripts.

Si l’écran ne peut pas être capturé ou enregistré, html vaut { "status": "failed", "error": "EVIDENCE_FAILED" } et la tâche se termine avec sa réponse. Une tâche ChatGPT avec location, CN, HK ou continueFrom, et une tâche Gemini avec location, CN, DE, GB ou IR, reviennent toujours sans page.

Cas d’usage

• Placez l’écran du moteur à côté de chaque chiffre d’un rapport client, pour montrer la réponse telle qu’un utilisateur l’a vue.
• Ouvrez la page quand un résultat analysé semble étrange, et voyez où la marque ou la source apparaissait à l’écran.
• Gardez une trace datée de ce que chaque moteur a répondu. Les pages restent 30 jours : téléchargez celles que vous voulez garder plus longtemps.

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": "PERPLEXITY",
    "payload": {
      "prompt": "What are the best CRM tools for a 10-person startup?",
      "country": "US",
      "include": { "html": 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.htmlboolean

Avec true, la réponse inclut html, un lien vers l’écran que le moteur a affiché avec la réponse. Sur CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE et AIMODE. Désactivé par défaut.

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": "7be8662e-5f62-48bf-a54a-7b58a2701b7c",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T01:20:07.445Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "For a 10-person startup, the strongest shortlist is **HubSpot** for a free, easy starting point; **Pipedrive** for a straightforward sales pipeline; **Zoho CRM** for budget-friendly customization; and **Attio** for a flexible, data-driven CRM.[1][2][3]\n\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://slack.com/blog/crm/best-crms-for-startups",
        "label": "Best CRMs for Startups: Tools, Benefits, and Tips"
      },
      {
        "position": 2,
        "url": "https://attio.com/f/best-crm-for-startups",
        "label": "Best CRMs for startups in 2026"
      }
    ],
    "html": {
      "status": "ok",
      "url": "https://api.querying.ai/v1/evidence/1792545851-e8cc8a32dd7f456eb807a0e09e9bc0fa.html",
      "expiresAt": "2026-11-20T01:24:11.000Z"
    }
  }
}

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

La réponse en texte brut.

response.sourcesarray

Les pages citées par la réponse, dans l’ordre du moteur, avec position, url et label.

response.htmlobject

L’écran du moteur : status (ok ou failed), url (s’ouvre sans clé d’API) et expiresAt, 30 jours après la fin de la tâche. Une page en échec porte error EVIDENCE_FAILED, et la tâche se termine quand même avec sa réponse.

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

EVIDENCE_UNSUPPORTEDHTTP 422

include.html est activé pour un moteur qui n’a pas de page. Seuls CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE et AIMODE en renvoient une.

VALIDATION_ERRORHTTP 400

Un champ manque ou sort des valeurs admises. details indique le champ.

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

Sur ChatGPT, Perplexity et Meta AI, la page ajoute 0,25 crédit au prix du moteur. Ces 0,25 crédit sont réservés à l’envoi et débités seulement quand html.status vaut ok. Sur Gemini, Google AI Overviews et AI Mode, la page est gratuite. Avec la page, une tâche sur n’importe lequel des six moteurs coûte 1,25 crédit, comme la tâche Perplexity de l’exemple.