Impressões

API + MCP

GET/v3/brand-radar/impressions-history

As 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

wherestring

A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso é diferente dos identificadores reconhecidos pelo parâmetro select).

report_idstring

O ID do relatório a ser usado. Se for fornecido, outros parâmetros são obtidos do relatório (país, filtros). Se país ou filtros forem fornecidos, eles substituem 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#/...

brandstringObrigatório

A marca a ser pesquisada.

data_sourcestringObrigatório

Uma lista de modelos de chatbot separados por vírgula. 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 / Modo de IA derivada de consultas de pesquisa do Google (palavras-chave) em vez de prompts.

Valores permitidos:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

Uma lista separada por vírgulas de códigos de país de duas letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazba…

promptsstring

O tipo de prompts a usar. Se não for especificado, ambos serão usados. Prompts personalizados exigem que um report_id seja fornecido.

Valores permitidos:ahrefscustom

date_fromstring (date)Obrigatório

A data de início do período histórico, no formato YYYY-MM-DD.

date_tostring (date)

A data de término do período histórico, no formato YYYY-MM-DD.

search_volume_typestring

Os relatórios de visibilidade de IA estão migrando para o volume ajustado por IA. Ele estima melhor a demanda por respostas de IA em chatbots e em superfícies de busca com IA. Ele é calculado ajustando o volume de pesquisa do Google de acordo com o uso estimado de cada plataforma de IA em comparação com o Google. Este parâmetro será descontinuado em 30 de setembro de 2026; todas as solicitações usarão o novo volume ajustado por IA.

Valores permitidos:ask_volumekeyword_volume

Padrão:ask_volume

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

metricsarray<object>

datestring (date)

impressionsinteger

Impressões estimadas de respostas que mencionam a marca.