Découvrez Prompt Research

Prompt Research transforme un sujet en questions que les gens posent aux assistants IA, classées selon la demande de recherche mensuelle derrière chacune.

Ce que vous obtenez

• prompts : jusqu’à 50 questions rédigées comme on les pose à un assistant IA, de la plus demandée à la moins demandée, chacune avec son volume de recherche mensuel et sa part de la demande du sujet.
• Le sujet, le persona, l’intention et l’étape du tunnel de chaque question, pour les regrouper par sous-domaine et par étape d’achat.
• monitorSet : les questions qu’un moniteur GEO doit suivre, dans l’ordre où les ajouter.
• brands : les marques concurrentes qui captent la demande de recherche dans le même espace.

Fonctionnement

Envoyez un sujet de départ, comme « crème solaire », et un marché. Prompt Research mesure la demande de recherche mensuelle liée à ce sujet sur ce marché, sur les 30 derniers jours pour KR et en moyenne mensuelle sur 12 mois pour US, repère les besoins les plus recherchés et formule chacun comme la question qu’une personne poserait à un assistant IA. KR renvoie des questions en coréen et US en anglais, et la plupart des exécutions se terminent en 30 à 60 secondes.

Ajoutez votre marque et une courte description de ce qu’elle vend : chaque question reçoit alors un score fit. Les questions qui contiennent le nom de votre marque sont écartées, si bien qu’un moniteur construit à partir d’elles mesure les mentions que votre marque obtient par elle-même.

L’onglet Recherche de prompts du Playground et le formulaire de nouveau moniteur lancent la même recherche.

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/prompt-research \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "seed": "wireless earbuds", "country": "US", "limit": 20 }'

Champs de la requête

seedstringObligatoire

Le sujet : 1 à 30 caractères de lettres, chiffres et espaces simples, par exemple sunscreen.

countrystringObligatoire

KR ou US. Les prompts sont rédigés dans la langue du marché.

limitinteger

Nombre de prompts renvoyés, de 1 à 50. Par défaut 20.

excludearray

Jusqu’à 20 termes. Un prompt qui en contient un sort du résultat.

monitorSizeinteger

Nombre de prompts dans monitorSet, de 1 à 50. Par défaut 20.

monitorEnginesarray

Les moteurs que votre moniteur interrogera. Vérifie que monitorSize tient dans les 200 tâches prompt × moteur d’un moniteur.

brandstring

Votre marque. Les prompts qui la nomment sortent du résultat : chaque prompt mesure une demande réelle.

brandDescriptionstring

Jusqu’à 500 caractères sur ce que vend votre marque et à qui. Ajoute fit à chaque prompt et favorise ceux auxquels vous répondez.

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": "ba954bab-33ec-4bb0-b175-a9b85258a4ac",
    "taskType": "PROMPT_RESEARCH",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:55:29.285Z"
  },
  "credits": { "creditsToCharge": 12, "creditsCharged": 12 },
  "response": {
    "seed": "wireless earbuds",
    "country": "US",
    "language": "en",
    "seedMonthlySearchVolume": 165000,
    "promptsFound": 28,
    "prompts": [
      {
        "prompt": "Which noise-cancelling earbuds should I choose?",
        "topic": "Earbud features",
        "persona": null,
        "intent": "commercial",
        "funnelStage": "consideration",
        "brandMentions": "likely",
        "monthlySearchVolume": 118380,
        "demandShare": 0.2585
      },
      {
        "prompt": "What are the best wireless earbuds to buy?",
        "topic": "Choosing earbuds",
        "persona": null,
        "intent": "commercial",
        "funnelStage": "consideration",
        "brandMentions": "likely",
        "monthlySearchVolume": 78840,
        "demandShare": 0.1722
      }
    ],
    "monitorSet": {
      "prompts": [
        {
          "rank": 1,
          "prompt": "Which noise-cancelling earbuds should I choose?",
          "topic": "Earbud features",
          "persona": null,
          "intent": "commercial",
          "funnelStage": "consideration",
          "brandMentions": "likely",
          "monthlySearchVolume": 118380,
          "demandShare": 0.2585
        }
      ],
      "coverage": {
        "demandShare": 0.8406,
        "topics": { "total": 5, "covered": 5 },
        "personas": { "total": 9, "covered": 8 }
      }
    },
    "topics": [
      {
        "topic": "Choosing earbuds",
        "monthlySearchVolume": 191440,
        "promptCount": 9,
        "demandShare": 0.4181
      },
      {
        "topic": "Earbud features",
        "monthlySearchVolume": 161940,
        "promptCount": 6,
        "demandShare": 0.3537
      }
    ],
    "personas": [
      {
        "persona": "people who sleep with earbuds",
        "monthlySearchVolume": 17700,
        "promptCount": 1,
        "demandShare": 0.0387
      }
    ],
    "brands": [
      { "brand": "Beats", "monthlySearchVolume": 560980 },
      { "brand": "Apple", "monthlySearchVolume": 509920 },
      { "brand": "Samsung", "monthlySearchVolume": 91750 }
    ]
  }
}

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

Les questions posées aux assistants IA, de la plus demandée à la moins demandée, avec topic, persona, intent, funnelStage, monthlySearchVolume et demandShare.

response.monitorSetobject

Les prompts qu’un moniteur doit suivre, dans l’ordre où les ajouter, avec la coverage de la demande, des sujets et des personas.

response.topicsarray

La demande cumulée par sous-thème, avec monthlySearchVolume, demandShare et promptCount. personas fait de même par public.

response.brandsarray

Les marques recherchées dans ce domaine, avec leurs recherches mensuelles.

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 de recherche terminée utilise 12 crédits.