API de visibilidade de marca e monitoramento GEO

Meça regularmente menções e citações da sua marca na busca com IA e compare com a concorrência.

01

Repetir as mesmas perguntas e condições

Salve variantes da marca, domínios, concorrentes, motores, perguntas e país. Programe intervalos de 1 a 168 horas. Mantenha as mesmas perguntas e motores para comparar períodos na mesma base.

02

Separar menções, citações e participação competitiva

Menções correspondem às variantes da marca no texto; citações correspondem aos domínios registrados nas fontes. Compare taxas de menção e participação competitiva dentro das respostas coletadas e avaliadas.

03

Acompanhar sua marca no ChatGPT

O exemplo executa a mesma pergunta diariamente no ChatGPT e Gemini. Separe perguntas de descoberta de categoria de comparações diretas de marcas. Cadastre variantes do nome em aliases e os sites oficiais cujas citações acompanhará em domains.

Métricas e denominadores da API

GET /v1/monitors/:id fornece as estatísticas do detalhe anterior; GET /v1/monitors/:id/analytics fornece métricas para relatórios. Diferencie as estruturas e os denominadores e consulte as respostas e fontes junto com os totais.

  • No detalhe anterior, engineRates compara menções e citações por motor; topDomains e topPages mostram as fontes citadas.
  • O shareOfVoice do detalhe anterior contém runs e brands[].mentions. Cada taxa de menção independente é calculada como mentions ÷ runs × 100.
  • Em analytics, brands[].mentionRate é menções da marca ÷ respostas avaliadas para ela × 100. brands[].shareOfVoice é menções da marca ÷ todas as menções de marcas acompanhadas × 100. Com denominador positivo, as participações somam 100%; valores sem amostra ou condições comparáveis são null.

Criar um monitor

Envie o corpo abaixo para POST /v1/monitors. Substitua a marca e o domínio de exemplo pelos alvos reais. Também é possível criar, editar e pausar monitores no painel.

JSON
{
  "name": "Earbud brand tracking",
  "engines": [
    "CHATGPT",
    "GEMINI"
  ],
  "prompts": [
    "best wireless earbuds for commuting"
  ],
  "aliases": [
    "Acme Audio"
  ],
  "domains": [
    "example.com"
  ],
  "competitors": [
    {
      "name": "Sony",
      "aliases": [
        "Sony"
      ]
    }
  ],
  "country": "US",
  "intervalHours": 24
}
01

Custos de tarefas e cobranças adicionais

Com uma amostra e uma localização, 12 perguntas no ChatGPT e Google AI Overviews criam 24 tarefas, com custo básico de 27 créditos se todas forem concluídas. A leitura de concorrentes acrescenta 80 créditos por monitor a cada 30 dias, distribuídos pela frequência e cobrados quando todas as tarefas de uma execução forem enviadas. Trinta execuções diárias custam cerca de 890 créditos: 810 de tarefas e 80 da leitura. analysis: true acrescenta 1 crédito por resposta analisada. O processamento respeita a concorrência e o saldo; associe cada resultado concluído pelo task.id.

02

Respostas e fontes do período em que uma taxa mudou

Abra as respostas e fontes desse período e confira se a composição das perguntas ou a presença de resumos de IA também mudou. Cadastre os domínios da marca para acompanhar suas citações.

Recursos relacionados

Comece com 500 créditos grátis

Execute sua primeira tarefa no Playground ou chame a API com sua chave.