Conheça o Prompt Research

O Prompt Research transforma um tema nas perguntas que as pessoas fazem a assistentes de IA e as ordena pela demanda de busca mensal por trás de cada uma.

O que você recebe

• prompts: até 50 perguntas escritas do jeito que se pergunta a um assistente de IA, da maior para a menor demanda, cada uma com seu volume de busca mensal e sua parcela na demanda do tema.
• O tema, a persona, a intenção e a etapa do funil de cada pergunta, para agrupá-las por subárea e etapa de compra.
• monitorSet: as perguntas que um monitor GEO deve acompanhar, na ordem em que devem ser adicionadas.
• brands: as marcas concorrentes que atraem demanda de busca no mesmo espaço.

Como funciona

Envie um tema inicial, como “protetor solar”, e um mercado. O Prompt Research mede a demanda de busca mensal desse tema no mercado, com os últimos 30 dias em KR e a média mensal dos últimos 12 meses em US, identifica as necessidades mais buscadas e escreve cada uma como a pergunta que uma pessoa faria a um assistente de IA. KR devolve perguntas em coreano e US em inglês, e a maioria das execuções termina em 30 a 60 segundos.

Adicione sua marca e uma breve descrição do que ela vende, e cada pergunta recebe uma pontuação fit. Perguntas que contêm o nome da sua marca ficam de fora, então um monitor criado a partir delas mede as menções que sua marca conquista por conta própria.

A aba Pesquisa de prompts do Playground e o formulário de novo monitor executam a mesma pesquisa.

Envie a requisição

Envie a requisição com a sua chave de API no cabeçalho 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 }'

Campos da requisição

seedstringObrigatório

O tema: de 1 a 30 caracteres entre letras, dígitos e espaços simples, como sunscreen.

countrystringObrigatório

KR ou US. Os prompts vêm no idioma do mercado.

limitinteger

Prompts retornados, de 1 a 50. Padrão 20.

excludearray

Até 20 termos. Um prompt que contenha algum sai do resultado.

monitorSizeinteger

Prompts em monitorSet, de 1 a 50. Padrão 20.

monitorEnginesarray

Os motores que o seu monitor vai rodar. Confere se monitorSize cabe nas 200 tarefas de prompt × motor de um monitor.

brandstring

Sua marca. Prompts que a citam saem do resultado, assim cada prompt mede demanda real.

brandDescriptionstring

Até 500 caracteres sobre o que sua marca vende e para quem. Adiciona fit a cada prompt e prioriza os prompts que você responde.

webhook.urlstring

Um endereço HTTPS do seu servidor. A tarefa concluída é enviada para lá assim que termina.

Resposta

Uma tarefa concluída chega assim, resumida para facilitar a leitura.

{
  "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 e, no fim, COMPLETED com a resposta ou FAILED com error.

credits.creditsChargedinteger

Créditos cobrados pela tarefa concluída. Uma tarefa que falhou cobra 0.

response.promptsarray

As perguntas que as pessoas fazem a assistentes de IA, da maior para a menor demanda, com topic, persona, intent, funnelStage, monthlySearchVolume e demandShare.

response.monitorSetobject

Os prompts que um monitor deve acompanhar, na ordem de inclusão, com a coverage de demanda, temas e personas.

response.topicsarray

A demanda somada por subtema, com monthlySearchVolume, demandShare e promptCount. personas faz o mesmo por público.

response.brandsarray

As marcas que as pessoas buscam neste setor, com as buscas mensais.

Receba o resultado

A requisição devolve a tarefa na hora, com status QUEUED. Consulte GET /v1/async/task/{id} até status virar COMPLETED ou FAILED, ou adicione webhook.url e a tarefa concluída chega ao seu servidor com os mesmos task, credits e response. Os resultados ficam disponíveis por 24 horas após o fim da tarefa.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Preço

Cada tarefa de pesquisa concluída usa 12 créditos.