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 reconocidos por el parámetro select).

limitinteger

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

Opción predeterminada:1000
datestring (date)

La fecha que se debe buscar en formato YYYY-MM-DD.

countrystring

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

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
report_idstring

El ID del informe que se va a usar. Si se proporciona uno, otros 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#/...

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
data_sourcestringObligatorio

Una lista de modelos de chatbot separados por comas. Los modelos de palabras clave de Google (google_ai_overviews_keywords, google_ai_mode_keywords) no se pueden combinar entre sí ni con otros modelos.

Valores permitidos:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
marketstring

Una lista separada por comas de los nichos de mercado de tus marcas. En desuso a partir del 2026-05-18, este parámetro dejará de tener efecto poco después de esa fecha.

competitorsstring

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

brandstring

Una lista separada por comas de marcas que se deben buscar. Al menos uno de brand, competitors, market o where no debe estar vacío.

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.