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
- Tipos de produto. Os dados de palavras-chave do mercado mostram os tipos de produto que as pessoas buscam dentro
do tema, como
sunscreen stickdentro desunscreen. Eles são oscores[]do resultado. - 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[].questionsdo resultado. Suas opções viram condições, junto com as variantes que as pessoas buscam (tinted sunscreen,sunscreen for oily skin). - Prompts. As condições se combinam em prompts até
depth, cada um com suas buscas medidas ou estimadas, em ordem recomendada.
Envie uma tarefa de pesquisa
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
USescreve 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.KRescreve prompts em coreano. A demanda conta os últimos 30 dias (demandSource.period: "last_30_days"). Oseedé 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 parasunscreen 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
Enviebrand 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.
limit. fit coloca mais à frente os prompts que a sua marca responde; os
números de demanda continuam iguais.
fit desta forma:
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, passeprompts[] 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:
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.
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.volumeReasondiz o motivo:not_searched(ninguém busca a condição),part_not_searched(uma das condições não é buscada) ouestimate_below_floor(a estimativa fica abaixo de 10). As opções decores[].questionsficam no resultado mesmo quando ninguém as busca, então uma pesquisa sobre um produto para empresas costuma retornar muitos promptsnull. - 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
Tarefas com falha
Uma tarefa com falha temstatus: "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.