Docs
Buscar documentación...⌘K

Dominios citados

API + MCP
GET/v3/brand-radar/cited-domains

Las solicitudes a este endpoint consumen unidades de API en función del parámetro prompts: las solicitudes que devuelven solo datos de prompt personalizado son gratuitas, mientras que las solicitudes que incluyen datos de prompt de Ahrefs siguen el precio estándar de unidades de API.

Parámetros de consulta

selectstringObligatorio

Una lista de campos separados por comas para devolver.

Campos disponibles:
  • domain
  • pages
  • responses
wherestring

La expresión de filtro. Se reconocen los siguientes identificadores de columna (esto difiere de los identificadores que reconoce el parámetro select).

report_idstring

El número de resultados que se devolverán.

brandstring

La fecha que se va a buscar, en formato AAAA-MM-DD.

competitorsstring

Los informes de visibilidad de IA están pasando al volumen ajustado por IA. Estima mejor la demanda de respuestas de IA en chatbots y superficies de búsqueda con IA. Se calcula ajustando el volumen de búsqueda de Google según el uso estimado de cada plataforma de IA en comparación con Google. Este parámetro quedará obsoleto el 30 de septiembre de 2026; todas las solicitudes usarán el nuevo volumen ajustado por IA.

data_sourcestringObligatorio

Una lista separada por comas de códigos de país de dos letras (ISO 3166-1 alpha-2).

Valores permitidos:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
countrystring

El ID del informe que se va a usar. Si se indica uno, el resto de parámetros se toman del informe (marca, competidores, mercado, país, filtros). Si se proporcionan país o filtros, anulan los del informe. Puedes encontrarlo en la URL de tu informe de Brand Radar en Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

Valores permitidos:adaeafagaialamaoarasatauawazba
promptsstring

El tipo de prompts que se van a usar. Si no se especifica, se usarán ambos. Los prompts personalizados requieren que se proporcione un report_id.

Valores permitidos:ahrefscustom
limitinteger

Una lista separada por comas de modelos de chatbot. Todos los modelos se pueden combinar entre sí. El módulo claude solo admite prompts personalizados.
Los modelos google_ai_overviews_keywords y google_ai_mode_keywords informan de la visibilidad de AI Overviews / Modo IA derivada de consultas de búsqueda de Google (palabras clave), en lugar de prompts.

Opción predeterminada:1000
datestring (date)

Una lista separada por comas de los mercados de nicho de tus marcas. Quedó obsoleto el 2026-05-18; este parámetro dejará de tener efecto poco después de esa fecha.

search_volume_typestring

Una lista separada por comas de los competidores de tus marcas.

Valores permitidos:ask_volumekeyword_volume
Opción predeterminada:ask_volume
outputstring

El formato de salida.

Valores permitidos:jsonphp

Respuestas

domainsarray<object>
domainstring

El nombre de dominio citado.

mentionsarray<object>

Obsoleto a partir del 2026-02-10.

pagesinteger

El número de páginas únicas del dominio que se citaron en las respuestas.

responsesinteger

El número de respuestas que citaron el dominio.

volumeinteger

Obsoleto a partir del 2026-03-24.