Fontes

Abrir não é citarCopiar link da seção

As tools de fontes contam um funil de três etapas:

totalConversations

Conversas monitoradas no período. É a base.

conversationsAppeared

Em quantas dessas a IA abriu a fonte pra montar a resposta.

conversationsCited

Em quantas ela citou a fonte, mostrando o link.

A diferença entre abrir e citar é leitura sem crédito: a página foi achada, mas não convenceu como resposta. Fontes abertas e nunca citadas (a "consulta silenciosa") ficam de fora por padrão; include_silent=true inclui.

A posição da fonte na resposta vem como bestPosition: 1 é fonte principal, 2 secundária, 3 menção.

get_top_sourcesCopiar link da seção

As fontes citadas nos prompts da marca, em dois níveis na mesma resposta:

• urls: as páginas específicas, até 30. É o nível que vira ação.
• domains: todos os domínios do período, até 25, com citations, distinctUrls e os totais do funil.

Quando urlsTruncated é true, existem mais páginas do que as listadas. Pra saber se um site é usado, olhe domains ou chame de novo com domain.

Pergunte assim: "quais sites as IAs mais usam pra responder sobre o meu mercado?"

brand_idstringobrigatório

UUID da marca.

domainstring

Só páginas desse domínio, ex.: g2.com.

brand_prompt_idstring

Só um prompt.

include_silentboolean

Inclui fontes abertas e nunca citadas. Padrão false.

limitinteger

Padrão 10, máximo 30.

periodenum

Padrão 7d.

start_date / end_datestring

Janela exata.

llm_providerstring

Só uma IA.

get_top_urlsCopiar link da seção

Ranking das páginas mais citadas, com a melhor posição em que cada uma apareceu.

Pergunte assim: "qual página do g2.com mais aparece?"

brand_idstringobrigatório

UUID da marca.

domainstring

Só páginas desse domínio.

brand_prompt_idstring

Só um prompt.

include_silentboolean

Inclui consulta silenciosa. Padrão false.

limitinteger

Padrão 15, máximo 30.

periodenum

Padrão 7d.

start_date / end_datestring

Janela exata.

llm_providerstring

Só uma IA.

find_prompts_citing_urlCopiar link da seção

O caminho inverso: dada uma página ou um domínio, em quais prompts ela foi aberta e citada. Serve pra saber onde o seu site (ou o de um concorrente) está influenciando as respostas.

Pergunte assim: "em quais prompts o g2.com aparece?", "onde a minha página /precos é citada?"

brand_idstringobrigatório

UUID da marca.

urlstring

Uma página. Protocolo, www, barra final e parâmetros de rastreio não atrapalham a comparação.

domainstring

Qualquer página desse domínio. Envie url ou domain, não os dois.

include_silentboolean

Inclui consulta silenciosa. Padrão false.

limitinteger

Padrão 25, máximo 100.

periodenum

Padrão 30d.

start_date / end_datestring

Janela exata.

llm_providerstring

Só uma IA.

get_search_queriesCopiar link da seção

As pesquisas na web que as IAs fizeram enquanto respondiam os prompts da marca. Mostra a intenção real por trás das respostas e ajuda a achar temas sem conteúdo.

Pergunte assim: "o que as IAs pesquisam quando respondem sobre o meu mercado?"

brand_idstringobrigatório

UUID da marca.

brand_prompt_idstring

Só um prompt.

limitinteger

Padrão 15, máximo 30.

periodenum

Padrão 7d.

start_date / end_datestring

Janela exata.

llm_providerstring

Só uma IA.

get_channel_presenceCopiar link da seção

Presença da marca nos recursos especiais das respostas: produtos de Shopping, o mapa de negócios locais do Google e posts do X citados pelo Grok. A conta é por conversa: em quantas o recurso apareceu e em quantas a marca estava nele. Pro mapa, traz também a posição média e os negócios concorrentes que mais aparecem.

Pergunte assim: "eu apareço no mapa do Google?", "quem domina o Shopping no meu mercado?"

brand_idstringobrigatório

UUID da marca.

periodenum

Padrão 7d.

start_date / end_datestring

Janela exata.

llm_providerstring

Só uma IA.