ChatGPT est désormais pris en charge

Posez une question à ChatGPT depuis le marché de votre choix et recevez en JSON la réponse que voit un vrai visiteur de ce marché, avec toutes les sources citées.

Ce que vous obtenez

• text et markdown : la réponse complète, en texte brut et avec sa mise en forme.
• sources : chaque page citée par la réponse, dans l’ordre, avec son URL et son titre.
• searchQueries : les recherches web lancées par ChatGPT pendant sa réponse, pour voir comment il a étudié votre prompt.
• model : le modèle qui a répondu dans cette session.

Fonctionnement

Chaque tâche ouvre une nouvelle session ChatGPT dans le pays choisi et pose votre question telle que vous l’avez écrite. Vous recevez la réponse qu’obtient un nouveau visiteur de ce marché : les marques recommandées et les pages citées sont celles que lisent vos clients.

Chaque exécution est une nouvelle observation. Répétez les mêmes prompts à intervalles réguliers et comparez les exécutions pour suivre l’évolution de la réponse, des marques recommandées et des pages citées.

Cas d’usage

• Vérifiez si ChatGPT recommande votre marque pour les questions de vos acheteurs.
• Repérez les pages que ChatGPT cite dans votre catégorie et bâtissez votre contenu autour d’elles.
• Comparez la réponse à un même prompt d’un pays à l’autre.

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": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US"
    }
  }'

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

Un lieu situé dans country, comme une gare, un quartier ou une adresse, jusqu’à 200 caractères. Le moteur répond comme à un utilisateur qui s’y trouve. Pour CHATGPT, GEMINI, GOOGLE, AIMODE et GOOGLE_SERP.

payload.include.markdownboolean

Renvoie markdown, la réponse avec ses titres, listes, tableaux et liens. Activé par défaut.

payload.include.searchQueriesboolean

Renvoie searchQueries, les recherches web lancées par ChatGPT pour la réponse. Activé par défaut.

payload.include.shoppingboolean

Renvoie dans shoppingCards les fiches produits affichées par ChatGPT. Activé par défaut.

payload.include.rawResponseboolean

Avec true, la sortie brute du moteur accompagne le résultat structuré, pour votre propre analyse. 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.

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": "8bafb0ff-3cc7-4bc4-99bf-32dbacaf7736",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.604Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "For commuting, I’d prioritize strong ANC (trains, buses, traffic) and 6+ hours of playback. These three are top picks:",
    "markdown": "| Earbuds | Noise cancellation | Battery life (ANC on) |\n|---|---|---|\n| Bose QuietComfort Ultra Earbuds (2nd Gen) | Excellent — among the strongest ANC available | ~6 hrs (24 hrs with case) … |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.wired.com/gallery/best-noise-canceling-earbuds/",
        "label": "Best Noise-Canceling Earbuds: Bose, Sony, Apple, and More | WIRED",
        "attribution": "WIRED",
        "datePublished": "March 29, 2026"
      },
      {
        "position": 2,
        "url": "https://www.tomsguide.com/audio/earbuds/best-noise-canceling-earbuds",
        "label": "Best noise-canceling earbuds in 2026: Tested and reviewed | Tom's Guide",
        "attribution": "Tom's Guide",
        "datePublished": "July 24, 2026"
      }
    ],
    "searchQueries": [
      "best wireless earbuds commuting noise cancellation battery life Sony Bose Apple"
    ]
  }
}

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

La réponse avec sa mise en forme : titres, listes, tableaux et liens.

response.sourcesarray

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

response.searchQueriesarray

Les recherches web lancées par le moteur pour rédiger la réponse.

response.shoppingCardsarray

Fiches produits affichées avec la réponse : nom, prix, boutique, note et lien.

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 ChatGPT terminée utilise 2 crédits.