Acompanhe um mercado inteiro com monitores de categoria

Classifique as marcas que os mecanismos de IA citam em um mercado, com share of voice e tendência diária.

O que você recebe

• Um ranking de cada marca acompanhada que as respostas citam, com posição, taxa de menção, share of voice e variação em relação ao intervalo anterior.
• As três marcas mais citadas em cada subárea e em cada mecanismo, para ver onde cada marca é forte.
• Taxas diárias das cinco marcas líderes e uma célula por prompt e mecanismo que abre a resposta por trás dela.

Como funciona

Um monitor de marca acompanha uma marca. Um monitor de categoria acompanha um mercado: você nomeia a categoria, agrupa os prompts por subárea, e cada execução faz esses prompts aos seus mecanismos e registra quais marcas cada resposta cita. Defina mode como CATEGORY ao criar; o tipo fica fixo durante toda a vida do monitor.

• category: o mercado como um comprador o chama, de 1 a 80 caracteres.
• promptTopics: liga cada prompt à sua subárea, com até 30 subáreas de no máximo 60 caracteres. Os prompts fora desse mapa cobrem a categoria inteira.
• competitors: até 25 marcas que você informa. Depois da primeira execução, uma leitura semanal das respostas adiciona até mais 25 marcas que elas citam.

GET /v1/monitors/{id}/analytics devolve o relatório. Em category.brands, o share of voice é 100 × as menções de uma marca ÷ todas as menções acompanhadas, então as parcelas de um período somam 100. A taxa de uma marca divide pelo próprio sampleSize, as respostas avaliadas enquanto ela estava na lista, então uma marca adicionada hoje é medida a partir de hoje.

Onde ajuda

• Descubra quais marcas lideram o seu mercado nas respostas de IA, e por quanto.
• Veja em quais subáreas e mecanismos cada concorrente domina.
• Reporte o share of voice da categoria toda semana para clientes ou para a diretoria.

Como começar

No painel, crie um monitor e escolha Categoria como tipo de monitor. Digite um tema e clique em Executar pesquisa: o Prompt Research preenche os prompts, as subáreas e as marcas para ordenar a partir da demanda de busca em KR ou US, e você revisa tudo antes de criar o monitor.

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/monitors \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Running shoes market (US)",
    "mode": "CATEGORY",
    "category": "Running shoes",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "What are the best running shoes to choose?",
      "What are the best trail running shoes to choose?",
      "What are the best waterproof running shoes to choose?"
    ],
    "promptTopics": {
      "What are the best running shoes to choose?": "Choosing running shoes",
      "What are the best trail running shoes to choose?": "Trail running shoes",
      "What are the best waterproof running shoes to choose?": "Running shoe features"
    },
    "competitors": [
      { "name": "HOKA" },
      { "name": "On" },
      { "name": "Nike" }
    ],
    "country": "US",
    "intervalHours": 168
  }'

Campos da requisição

namestringObrigatório

Um nome para o monitor.

modestringObrigatório

BRAND (padrão) acompanha sua marca. CATEGORY classifica todas as marcas de um mercado.

categorystringObrigatório

O nome do mercado, de 1 a 80 caracteres.

enginesarrayObrigatório

Motores consultados, até 12, como CHATGPT, GEMINI, PERPLEXITY e GOOGLE.

promptsarrayObrigatório

De 1 a 100 perguntas feitas a cada execução, escritas como um comprador pergunta.

promptTopicsobject

Associa cada prompt a um subsetor, como Kids. O relatório classifica as marcas por subsetor.

competitorsarray

As marcas classificadas desde o início, até 25. A leitura semanal adiciona até 25 a partir das respostas.

countrystring

O mercado para o qual os motores respondem. Padrão US.

intervalHoursinteger

Horas entre execuções, de 1 a 168: 1 a cada hora, 24 diária, 168 semanal.

Resposta

A resposta, resumida para facilitar a leitura.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY",
      "category": "Running shoes",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 168,
      "enabled": true,
      "nextRunAt": "…"
    }
  }
}

data.monitor.idstring

O ID do monitor. Use-o para ler o relatório, os resultados pontuados e cada resposta.

data.monitor.nextRunAtstring

Quando começa a próxima execução. A primeira começa assim que o monitor é criado e depois roda a cada intervalHours.

Leia o relatório

GET /v1/monitors/{id}/analytics devolve o relatório dos últimos 30 dias. Os números abaixo vêm do relatório público de tênis de corrida, resumidos para facilitar a leitura.

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/analytics" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)",
      "mode": "CATEGORY"
    },
    "window": {
      "since": "2026-09-02T17:23:17.290Z",
      "until": "2026-10-02T17:23:17.290Z"
    },
    "category": {
      "name": "Running shoes",
      "brands": [
        {
          "rank": 1,
          "name": "On",
          "mentions": 21,
          "sampleSize": 21,
          "mentionRate": 100,
          "shareOfVoice": 18.421052631578945,
          "changePp": null
        },
        {
          "rank": 2,
          "name": "HOKA",
          "mentions": 15,
          "sampleSize": 21,
          "mentionRate": 71.42857142857143,
          "shareOfVoice": 13.157894736842104,
          "changePp": null
        },
        {
          "rank": 3,
          "name": "Nike",
          "mentions": 14,
          "sampleSize": 21,
          "mentionRate": 66.66666666666666,
          "shareOfVoice": 12.280701754385964,
          "changePp": null
        }
      ],
      "topics": [
        {
          "topic": "Trail running shoes",
          "prompts": 1,
          "runs": 3,
          "leaders": [
            { "name": "HOKA", "mentionRate": 100 },
            { "name": "On", "mentionRate": 100 },
            { "name": "Salomon", "mentionRate": 100 }
          ]
        }
      ]
    }
  }
}

category.brandsarray

As marcas da sua lista e todas as outras que as respostas citam, da mais para a menos citada, com rank, mentionRate e shareOfVoice.

category.topicsarray

A mesma classificação para cada subsetor, na ordem em que o monitor pergunta.

Exporte as respostas

GET /v1/monitors/{id}/results traz uma linha por resposta, com as marcas citadas em competitorHits. Acrescente format=csv para receber um arquivo que abre em qualquer planilha:

curl "https://api.querying.ai/v1/monitors/$MONITOR_ID/results?format=csv" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

ran_at,monitor,engine,prompt,mentioned,cited,position,competitors,task_id
2026-09-30T11:52:14.381000Z,Running shoes market (US),PERPLEXITY,What are the best barefoot running shoes to choose?,false,false,,On | Nike | Vibram | Merrell | Xero Shoes | Vivobarefoot | Whitin,39bc264d-205f-4824-8750-7bb6564fa4d0
2026-09-30T11:51:33.415000Z,Running shoes market (US),PERPLEXITY,What are the best waterproof running shoes to choose?,false,false,,HOKA | On | Brooks | Salomon,bc96f867-7349-4987-b498-f0080c149f3d
2026-09-30T11:51:14.888000Z,Running shoes market (US),PERPLEXITY,What are the best running shoes for kids?,false,false,,HOKA | On | ASICS | Nike | New Balance,6b8222fd-01bd-44d7-9a0b-8d0aecb32e19

Preço

Uma execução custa o mesmo que a de um monitor de marca: uma tarefa por prompt e mecanismo, pelo preço em créditos de cada mecanismo. Encontrar as marcas do mercado soma 100 créditos por mês, divididos entre as execuções, e a pesquisa que preenche o formulário custa 12 créditos.