Visão geral - Impressõ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 prompt personalizado são gratuitas, enquanto solicitações que incluem dados de prompt da Ahrefs seguem o preço padrão de unidades de API.
Parâmetros de consulta
A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (eles são diferentes dos identificadores reconhecidos pelo parâmetro select).
Uma lista de campos separados por vírgula para retornar.\n\n- brand\n- no_tracked_brands\n- only_competitors_brands\n- only_target_brand\n- target_and_competitors_brands\n- total
Os relatórios de visibilidade de IA estão migrando para o volume ajustado por IA. Essa métrica estima melhor a demanda por respostas de IA em chatbots e em superfícies de busca com IA. O cálculo é feito ajustando o volume de pesquisa do Google para o uso estimado de cada plataforma de IA em comparação com o Google. Este parâmetro será descontinuado em 31 de agosto de 2026; todas as solicitações usarão o novo volume ajustado por IA.
Uma lista separada por vírgulas de códigos de país de duas letras (ISO 3166-1 alpha-2).
O ID do relatório a ser usado. Se for fornecido, outros parâmetros serão obtidos do relatório (marca, concorrentes, mercado, país, filtros). Se país ou filtros forem fornecidos, 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 serem usados. Se não for especificado, ambos serão usados. Prompts personalizados exigem que um report_id seja fornecido.
Uma lista separada por vírgulas de modelos de chatbot. Todos os modelos podem ser combinados entre si. O módulo claude oferece suporte apenas a prompts personalizados.
Os modelos google_ai_overviews_keywords e google_ai_mode_keywords informam a visibilidade de AI Overviews / AI Mode derivada de consultas de pesquisa do Google (palavras-chave), em vez de prompts.
Uma lista separada por vírgulas dos mercados de nicho das suas marcas. Descontinuado em 18/05/2026, este parâmetro deixará de ter efeito pouco depois dessa data.
Uma lista separada por vírgulas dos concorrentes das suas marcas.
Uma lista separada por vírgulas de marcas para pesquisar. Pelo menos um destes parâmetros — brand, competitors, market ou where — não pode ficar vazio.
O formato de saída.
Respostas
Nome da marca (a sua marca ou um concorrente informado na solicitação).
Impressões estimadas de respostas relacionadas ao mercado especificado que não mencionam nenhuma das marcas fornecidas (o valor é zero quando market não é especificado).
Impressões estimadas de respostas que mencionam apenas marcas de concorrentes.
Impressões estimadas de respostas que mencionam apenas a sua marca.
Impressões estimadas de respostas que mencionam tanto a sua marca quanto marcas de concorrentes.
Total de impressões estimadas para a sua marca (inclui only_target_brand e target_and_competitors_brands).