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 separada por vírgulas de campos a serem retornados.

Campos disponíveis:

responses
title
url

wherestring

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

report_idstring

O ID do relatório a ser usado. Se um ID for informado, os outros parâmetros serão obtidos do relatório (brand, competitors, market, country, filters). Se os parâmetros country ou filters 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#/...

brandstring

Uma lista separada por vírgulas de marcas a serem pesquisadas. Pelo menos um dos parâmetros brand, competitors, market ou where não deve estar vazio.

competitorsstring

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

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

limitinteger

O número de resultados a retornar.

Padrão:1000

datestring (date)

A data a ser pesquisada, no formato YYYY-MM-DD.

tracked_urlsstring

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

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.

titlestring or null

O título da página conforme exibido na citação da resposta da IA ou, quando nenhuma resposta tiver registrado um, o título da página rastreada. null se nenhum dos dois for conhecido.

urlstring

A URL da página citada.

volumeinteger

Obsoleto em 2026-03-24.