Visão geral - Menções
API + MCPAs solicitações para este endpoint consomem unidades de API com base no parâmetro
prompts: solicitações que retornam apenas dados de prompts personalizados são gratuitas, enquanto solicitações que incluem dados de prompts da Ahrefs seguem a precificação padrão de unidades de API.
Cada entidade fornecida em brands (e em competitors, quando aplicável) deve incluir pelo menos um valor em names. Entidades compostas apenas por url_groups não são aceitas aqui, porque as menções são comparadas com os nomes das marcas.
Corpo da solicitação
A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso difere dos identificadores reconhecidos pelo parâmetro select).
Uma lista de campos para retornar.\n\n- brand\n- no_tracked_brands\n- only_competitors_brands\n- only_target_brand\n- target_and_competitors_brands\n- total
Uma expressão de filtro para tags do prompt. Requer report_id. Usa a sintaxe de filtro com as seguintes restrições: o único nome de campo válido é "tag"; os únicos operadores válidos são: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; a profundidade máxima de aninhamento de and, or é 2. Exemplo: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.
Uma lista de códigos de país de duas letras (ISO 3166-1 alfa-2).
O ID do relatório a ser usado. Se um for informado, os outros parâmetros são obtidos do relatório (marca, concorrentes, mercado, país, filtros). Se país ou filtros forem informados, eles substituirão os do relatório. Você pode encontrá-lo na URL do seu relatório do Brand Radar no Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...
O tipo de prompts a usar. Se não for especificado, ambos serão usados. Prompts personalizados exigem que um report_id seja informado.
Uma lista de modelos de chatbot. Os modelos de palavras-chave do Google (google_ai_overviews_keywords, google_ai_mode_keywords) não podem ser combinados entre si nem com outros modelos.
Uma lista dos nichos de mercado das suas marcas. Obsoleto em 2026-05-18, este parâmetro não terá mais efeito logo após essa data.
Uma lista de nomes e sites de concorrentes para pesquisar.
names or url_groups is requiredOs nomes da marca/concorrente
O domínio do alvo
Escopo do alvo.
Uma lista de nomes e sites de marcas para pesquisar.
names or url_groups is requiredOs nomes da marca/concorrente
O domínio do alvo
Escopo do alvo.
O formato de saída.
Respostas
Nome da marca (a sua marca ou um concorrente informado na solicitação).
Menções estimadas de respostas relacionadas ao mercado especificado que não mencionam nenhuma das marcas fornecidas (o valor é zero quando market não é especificado).
Menções estimadas de respostas que mencionam apenas marcas de concorrentes.
Menções estimadas de respostas que mencionam apenas a sua marca.
Menções estimadas de respostas que mencionam tanto a sua marca quanto marcas de concorrentes.
Total de menções estimadas para a sua marca (inclui only_target_brand e target_and_competitors_brands).