Domínios citados

API + MCP

POST/v3/brand-radar/cited-domains

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.

Corpo da solicitação

selectarray<string>Required

Uma lista de campos para retornar.\n\n- domain\n- pages\n- responses

Example:["field_a","field_b"]

whereobject

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#/...

brandsarray<object>

Uma lista de nomes e sites de marcas para pesquisar.

Default:[]

At least one of names or url_groups is required

namesarray<string>

Os nomes da marca/concorrente

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstring (domain)required

O domínio do alvo

Example:ahrefs.com

scopestringrequired

Escopo do alvo.

Valores permitidos:urlpathdomainsubdomains

competitorsarray<object>

Uma lista de nomes e sites de concorrentes para pesquisar.

Default:[]

At least one of names or url_groups is required

namesarray<string>

Os nomes da marca/concorrente

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstring (domain)required

O domínio do alvo

Example:ahrefs.com

scopestringrequired

Escopo do alvo.

Valores permitidos:urlpathdomainsubdomains

content_filterobject

Frases opcionais usadas para incluir ou excluir resultados com base no conteúdo.

includearray<string>

Mostrar apenas resultados que contenham pelo menos uma destas frases exatas.

excludearray<string>

Ocultar resultados que contenham qualquer uma destas frases exatas.

data_sourcearray<string>Required

Uma lista 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.

Valores permitidos:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

countryarray<string>

Uma lista de códigos de país de duas letras (ISO 3166-1 alfa-2).

Valores permitidos:adaeafagaialamaoarasatauawazba…

Default:[]

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.

Default:1000

datestring (date)

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

tags_filterobject

Uma expressão de filtro para tags de 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 e or é 2.

Example:{"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}

brand_filterobject

Uma expressão de filtro para a visibilidade da sua marca, seguindo o mesmo comportamento do filtro “Sua marca”. brand_name indica se uma resposta menciona sua marca: "mentioned" ou "not_mentioned". page_status indica como a IA usou suas páginas: "cited" (a IA recuperou páginas do seu site e fez referência a elas na resposta), "found_but_not_cited" (a IA recuperou páginas do seu site como possíveis fontes, mas não fez referência a elas na resposta final) ou "not_found" (a IA não recuperou nenhuma página do seu site).
Usa a sintaxe de filtro com as seguintes restrições: o único operador válido é "eq"; cada campo deve ser uma seção: forneça um único valor ou combine vários valores do mesmo campo com or; una as seções brand_name e page_status com um and/or no nível superior. Selecionar todos os valores de um campo será rejeitado, pois corresponderia a tudo (omita o campo em vez disso).

Example:{"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}

volume_rangeobject

O intervalo de volume para filtrar.

frominteger

tointeger

outputstring

O formato de saída.

Valores permitidos:jsonphp

Respostas

domainsarray<object>

domainstring

O nome do domínio citado.

mentionsarray<object>

Obsoleto em 2026-02-10.

pagesinteger

O número de páginas únicas do domínio que foram citadas nas respostas.

responsesinteger

O número de respostas que citaram o domínio.

volumeinteger

Obsoleto em 2026-03-24.

curl "https://api.ahrefs.com/v3/brand-radar/cited-domains" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "select": ["field_a","field_b"], "where": {}, "report_id": "string", "brands": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "competitors": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "content_filter": { "include": ["string"], "exclude": ["string"] }, "data_source": ["chatgpt"], "country": ["ad"], "prompts": "ahrefs", "limit": 0, "date": "string", "tags_filter": {"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}, "brand_filter": {"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}, "volume_range": { "from": 0, "to": 0 }, "output": "json" }'