Concorrentes
Quem aparece junto com a sua marca nas respostas e quem está cadastrado pra comparação.
get_competitors_overview
Ranking das marcas concorrentes pelo número de conversas em que apareceram no período. Cada item traz conversationsWithMention, mentionRatePct e totalConversations, o denominador usado.
Pergunte assim: "quem mais aparece junto comigo no ChatGPT?", "qual o share of voice dos concorrentes?"
- brand_idstringobrigatório
- UUID da marca.
- limitinteger
- Padrão 10, máximo 25.
- periodenum
- Padrão
7d. - start_date / end_datestring
- Janela exata.
- llm_providerstring
- Só uma IA. Sem ele, o ranking soma todas.
- segment_idstring
- Só concorrentes que apareceram nos prompts desse segmento.
Se você filtrou outras consultas por IA ou por segmento, use o mesmo filtro aqui. Senão o totalConversations soma todas as IAs e os números deixam de ser comparáveis.
list_competitors
O inventário de concorrentes cadastrados na marca, incluindo os recém-adicionados que ainda não foram citados. Retorna id, name, website, active e creationType (Manual ou System).
Pergunte assim: "quais concorrentes eu tenho cadastrados?"
- brand_idstringobrigatório
- UUID da marca.
- include_inactiveboolean
- Inclui os desativados. Padrão
false. - searchstring
- Parte do nome ou do site.
- limitinteger
- Padrão 50, máximo 100.