Páginas citadas

API + MCP

GET/v3/brand-radar/cited-pages

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

selectstringObrigatório

Uma lista de campos separados por vírgula para retornar.\n\n- responses\n- url

wherestring

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

limitinteger

O número de resultados a retornar.

Padrão:1000

datestring (date)

A data a pesquisar, no formato YYYY-MM-DD.

search_volume_typestring

Os relatórios de visibilidade de IA estão migrando para o volume ajustado para IA. Ele estima melhor a demanda por respostas de IA em chatbots e superfícies de pesquisa com IA. Ele é calculado ajustando o volume de pesquisa do Google pelo 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 para IA.

Valores permitidos:ask_volumekeyword_volume

Padrão:ask_volume

countrystring

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

Valores permitidos:adaeafagaialamaoarasatauawazba…

tracked_urlsstring

Uma lista separada por vírgulas de URLs de páginas monitoradas. Quando informada, a resposta inclui linhas com zero citações para URLs monitoradas que não tenham dados.

report_idstring

O ID do relatório a ser usado. Se um for fornecido, outros parâmetros sã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 na Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

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

data_sourcestringObrigatório

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), e não de prompts.

Valores permitidos:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Uma lista separada por vírgulas dos nichos de mercado das suas marcas. Descontinuado em 2026-05-18, este parâmetro deixará de ter efeito pouco depois dessa data.

competitorsstring

Uma lista separada por vírgulas dos concorrentes das suas marcas.

brandstring

Uma lista separada por vírgulas de marcas a pesquisar. Pelo menos um entre brand, competitors, market ou where não deve estar vazio.

outputstring

O formato de saída.

Valores permitidos:jsonphp

Respostas

pagesarray<object>

mentionsarray<object>

Obsoleto em 2026-02-10.

responsesinteger

O número de respostas que citaram a página.

urlstring

A URL da página citada.

volumeinteger

Obsoleto em 2026-03-24.