Fique de olho na sua marca nas respostas de IA

Os monitores enviam o seu conjunto de prompts aos mecanismos de IA que você escolher, na frequência definida, e pontuam cada resposta pelas menções e citações da sua marca.

O que você recebe

• Taxa de menções: a parcela de respostas que mencionam a sua marca, por mecanismo e por prompt.
• Taxa de citações: a parcela de respostas que citam um dos seus domínios.
• Uma tabela de prompts por mecanismos que mostra onde a sua marca aparece, com a resposta completa por trás de cada célula.
• Um alerta por e-mail quando a taxa de menções cai abaixo do limite que você definir.

Como funciona

Um monitor é um conjunto de prompts com nome para um mercado: os prompts, os mecanismos a consultar, os nomes que identificam a sua marca, os seus domínios, um país e uma frequência, de hora em hora a semanal. Cada execução envia todos os prompts a todos os mecanismos e pontua cada resposta uma vez: se ela menciona a sua marca e onde, se cita os seus domínios e quais concorrentes aparecem ao seu lado.

Cada número leva às respostas por trás dele, então quando uma taxa se move você abre na hora as respostas que mudaram e vê o que os mecanismos disseram.

Onde ajuda

• Acompanhe semana a semana a sua presença nas respostas de IA às perguntas dos seus compradores.
• Encontre os prompts e mecanismos em que os concorrentes aparecem à sua frente.
• Veja como as taxas de menções e citações se movem depois que você publica conteúdo novo.

Como começar

Crie um monitor em Monitores no painel ou com POST /v1/monitors. Um prompt que contém o nome da sua marca sempre conta como menção, então escreva os prompts com as palavras de um comprador.

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, US",
    "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
    "prompts": [
      "best running shoes for flat feet",
      "most comfortable running shoes for beginners"
    ],
    "aliases": ["Acme", "Acme Running"],
    "domains": ["acme.com"],
    "country": "US",
    "intervalHours": 24,
    "alertBelowPct": 30
  }'

Campos da requisição

namestringObrigatório

Um nome para o monitor.

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.

aliasesarrayObrigatório

Os nomes e grafias da sua marca, até 20. Uma resposta que use um conta como menção.

domainsarray

Seus sites, até 20. Uma resposta que cita um conta como citação.

competitorsarray

Marcas para comparar, cada uma com name e aliases. A leitura semanal adiciona as que as respostas citam.

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.

alertBelowPctinteger

Alerta por e-mail quando sua taxa de menção cai abaixo desta porcentagem, de 1 a 100.

Resposta

A resposta, resumida para facilitar a leitura.

{
  "success": true,
  "data": {
    "monitor": {
      "id": "…",
      "name": "Running shoes, US",
      "mode": "BRAND",
      "engines": ["CHATGPT", "GEMINI", "PERPLEXITY"],
      "country": "US",
      "intervalHours": 24,
      "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 os resultados

Cada execução acrescenta uma linha por prompt e mecanismo. GET /v1/monitors/{id}/results traz as linhas da mais recente para a mais antiga, e nextCursor volta como cursor para a página seguinte. Estas linhas vêm do relatório público de tênis de corrida, resumidas para facilitar a leitura.

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

{
  "success": true,
  "data": {
    "monitor": {
      "id": "0b787ca9-f680-47ac-beaa-72c383b597c1",
      "name": "Running shoes market (US)"
    },
    "truncated": true,
    "nextCursor": "2026-09-30T11:51:14.888000Z~7fc7c713-a2f2-41f8-befd-c04b830d69e5",
    "results": [
      {
        "taskId": "bc96f867-7349-4987-b498-f0080c149f3d",
        "engine": "PERPLEXITY",
        "prompt": "What are the best waterproof running shoes to choose?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:33.415000Z",
        "competitorHits": ["HOKA", "On", "Brooks", "Salomon"]
      },
      {
        "taskId": "6b8222fd-01bd-44d7-9a0b-8d0aecb32e19",
        "engine": "PERPLEXITY",
        "prompt": "What are the best running shoes for kids?",
        "mentioned": false,
        "cited": false,
        "position": null,
        "ranAt": "2026-09-30T11:51:14.888000Z",
        "competitorHits": ["HOKA", "On", "ASICS", "Nike", "New Balance"]
      }
    ]
  }
}

mentionedboolean

true quando a resposta cita sua marca por um dos aliases.

citedboolean

true quando a resposta cita uma página de um dos seus domains.

positioninteger

Posição em caracteres da primeira menção à sua marca, uma medida de destaque. null quando a resposta deixa sua marca de fora.

competitorHitsarray

Os concorrentes que a resposta cita.

taskIdstring

A resposta por trás da linha. GET /v1/monitors/{id}/answers/{taskId} a retorna completa, com as fontes.

Preço

Uma execução custa o número de prompts multiplicado pelos créditos de cada mecanismo. Por exemplo, 12 prompts no ChatGPT (2 créditos) e no Gemini (1 crédito) custam 36 créditos por execução, cerca de 1.080 por mês com frequência diária.