Saltar para o conteúdo principal
O Prompt Research encontra os melhores prompts que os compradores enviam a assistentes de IA sobre um tema. Envie um tema e o resultado lista primeiro o pedido básico de cada tipo de produto, depois o mesmo pedido com as condições que os compradores acrescentam, como um orçamento, um tipo de pele ou um setor. Cada prompt traz as buscas mensais por trás dele, prompts[] está em ordem recomendada, e brands[] mostra quais marcas atraem demanda de busca no mesmo segmento. Use os prompts para planejar conteúdo, enviá-los a mecanismos de resposta ou acompanhar as respostas em um monitor GEO.

Como os prompts são encontrados

  1. Tipos de produto. Os dados de palavras-chave do mercado mostram os tipos de produto que as pessoas buscam dentro do tema, como sunscreen stick dentro de sunscreen. Eles são os cores[] do resultado.
  2. Condições. Para cada tipo, a pesquisa encontra as perguntas que estreitam a escolha do comprador, como tipo de pele, orçamento ou tamanho da equipe. Elas são as cores[].questions do resultado. Suas opções viram condições, junto com as variantes que as pessoas buscam (tinted sunscreen, sunscreen for oily skin).
  3. Prompts. As condições se combinam em prompts até depth, cada um com suas buscas medidas ou estimadas, em ordem recomendada.
Uma pesquisa leva de 1 a 3 minutos.

Envie uma tarefa de pesquisa

A tarefa é aceita e entra na fila:
Leia o resultado com GET /v1/async/task/{id}, ou adicione webhook.url à requisição e receba-o quando a tarefa terminar. A tarefa funciona como qualquer outra tarefa assíncrona, e o resultado fica em response. O schema da requisição está na referência da API.
Envie o Prompt Research somente por POST /v1/prompt-research. POST /v1/async/task rejeita taskType: "PROMPT_RESEARCH".

Campos da requisição

O corpo é plano: os campos da pesquisa e as opções da tarefa ficam no nível superior.

Mercados

  • US escreve prompts em inglês. A demanda é a média mensal dos últimos 12 meses (demandSource.period: "monthly_average_last_12_months"), por isso um termo sazonal aparece mais baixo no pico do que as buscas daquele mês.
  • KR escreve prompts em coreano. A demanda conta os últimos 30 dias (demandSource.period: "last_30_days"). O seed é comparado com dados de busca coreanos, então envie-o como as pessoas o escrevem ao buscar em coreano.
language no resultado é en para US e ko para KR.

Profundidade

depth define quantas condições um prompt combina, e toda profundidade até esse valor aparece em prompts: As opções de uma mesma pergunta são alternativas, então um prompt combina pele oleosa com um orçamento e nunca com pele seca. Cada profundidade precisa de pelo menos um prompt, então limit deve ser no mínimo depth + 1. depth: 0 retorna o pedido básico de cada tipo e as perguntas que as pessoas buscam sobre o tema.

Leia o resultado

Por exemplo, uma execução para sunscreen nos EUA retorna um resultado como este, reduzido a poucas entradas:

prompts[]

Os prompts em ordem recomendada, até limit itens. Os prompts de cada core começam pelo pedido básico e pelas duas faixas de preço, e depois seguem por demanda entre as profundidades. Os cores se revezam na proporção das suas buscas, com todos os pedidos básicos primeiro, então qualquer trecho inicial da lista se distribui como a lista inteira. As perguntas que as pessoas fazem para se informar sobre o tema (intent: "informational") ocupam cerca de um quinto da lista quando a pesquisa as encontra, porque os compradores as fazem antes de escolher. Para ordenar só por demanda, ordene por monthlySearchVolume.

cores[]

Os tipos de produto pesquisados, primeiro o do próprio seed. Envie cores na requisição para pesquisar os tipos que você escolher.

brands[] e outros campos

brands[] lista marcas, fabricantes e linhas de produtos que as pessoas buscam nesse segmento, com o monthlySearchVolume de cada um. Essa demanda fica fora de prompts, porque os prompts não citam marcas. Use-as como os concorrentes com que comparar sua marca.

Pontue os prompts em relação à sua marca

Envie brand com brandDescription e cada prompt recebe um fit:
  • core: a descrição diz que a sua marca oferece o que o prompt pede.
  • related: tudo o que a descrição não menciona.
Um tipo de produto ou uma condição que a descrição exclui, como outro público ou outro produto, fica de fora, então um resultado pode ter menos prompts do que limit. fit coloca mais à frente os prompts que a sua marca responde; os números de demanda continuam iguais.
Por exemplo, os prompts de um resultado assim trazem fit desta forma:
A descrição é avaliada como está escrita, então com uma única linha a maioria dos prompts fica related. Para deixar um subtema totalmente fora do resultado, use exclude.

Da pesquisa a um monitor

Para acompanhar com que frequência as respostas de IA mencionam sua marca nesses prompts, passe prompts[] para POST /v1/monitors. Este comando pega a tarefa de pesquisa concluída, usa os prompts dela como prompts do monitor e as dez primeiras brands[] como concorrentes (um monitor de marca aceita até 10), e cria um monitor de marca diário:
A lista está em ordem recomendada, então os N primeiros prompts formam um monitor equilibrado de N prompts. Uma execução de monitor pode enfileirar no máximo o limite tasksPerRun da sua conta (200 em uma conta self-service; GET /v1/monitors/capabilities informa o seu), contado para cada mecanismo como prompts × pontos de localização × samples. Quarenta prompts em cinco mecanismos, com um ponto e uma amostra cada, dão 200 tarefas.
Criar um monitor inicia a primeira execução imediatamente, e cada execução é cobrada como as tarefas que enfileira. Confira a quantidade de prompts e mecanismos antes de criá-lo.
Para um monitor de categoria, envie "mode": "CATEGORY" com uma category e, quando a pesquisa tiver mais de um core, associe cada prompt ao seu core em promptTopics. Veja Monitores para os dois tipos e a requisição completa.

Como ler os números

  • As profundidades 0 e 1 são medidas. Um pedido básico traz as buscas do seu tipo, e um prompt com uma condição, as buscas da sua palavra-chave (conditions[0].keyword).
  • Da profundidade 2 em diante, os números são estimados. Um prompt com duas ou mais condições raramente é buscado como está escrito, então o número dele é uma estimativa (volumeBasis: "estimated"). Use as estimativas para ordenar os prompts.
  • Prompts amplos incluem os mais específicos. As buscas por sunscreen incluem as de mineral sunscreen, então não some os números de prompts diferentes.
  • Menos de 10 buscas por mês aparece como null. volumeReason diz o motivo: not_searched (ninguém busca a condição), part_not_searched (uma das condições não é buscada) ou estimate_below_floor (a estimativa fica abaixo de 10). As opções de cores[].questions ficam no resultado mesmo quando ninguém as busca, então uma pesquisa sobre um produto para empresas costuma retornar muitos prompts null.
  • Os números são demanda de busca. Eles contam as buscas pela necessidade por trás de cada prompt no mercado, ao longo de demandSource.period.

Erros e cobrança

Uma tarefa concluída custa 14 créditos. Uma tarefa que falha não é cobrada. Veja Créditos e limites.

Rejeitadas no envio

Os erros de autenticação, créditos e concorrência são os mesmos de qualquer tarefa. Veja Erros.

Tarefas com falha

Uma tarefa com falha tem status: "FAILED" e uma string error que começa com o código:

Próximos passos

Monitores GEO

Acompanhe os prompts encontrados nos mecanismos de IA de forma agendada.