Páginas citadas

API + MCP

POST/v3/brand-radar/cited-pages

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.

Cuerpo de la solicitud

selectarray<string>Required

Una lista de campos para devolver.

Campos disponibles:

responses
url

Example:["field_a","field_b"]

whereobject

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

report_idstring

El ID del informe que se usará. Si se proporciona uno, los demás parámetros se toman del informe (marca, competidores, mercado, país, filtros). Si se proporcionan el país o los filtros, prevalecen sobre 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#/...

brandsarray<object>

Una lista de nombres de marcas y sitios web que se deben buscar.

Default:[]

At least one of names or url_groups is required

namesarray<string>

Los nombres de la marca o del competidor

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

url_groupsarray<object>

targetstring (domain)required

El dominio del objetivo

Example:ahrefs.com

scopestringrequired

Ámbito del objetivo.

Valores permitidos:urlpathdomainsubdomains

competitorsarray<object>

Una lista de nombres de competidores y sitios web que se deben buscar.

Default:[]

At least one of names or url_groups is required

namesarray<string>

Los nombres de la marca o del competidor

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

url_groupsarray<object>

targetstring (domain)required

El dominio del objetivo

Example:ahrefs.com

scopestringrequired

Ámbito del objetivo.

Valores permitidos:urlpathdomainsubdomains

content_filterobject

Optional phrases used to include or exclude results based on their content.

includearray<string>

Only show results containing at least one of these exact phrases.

excludearray<string>

Hide results containing any of these exact phrases.

data_sourcearray<string>Required

Una lista 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 sobre la visibilidad en AI Overviews / AI Mode derivada de consultas de búsqueda de Google (palabras clave), en lugar de prompts.

Valores permitidos:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

countryarray<string>

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

Valores permitidos:adaeafagaialamaoarasatauawazba…

Default:[]

promptsstring

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

Valores permitidos:ahrefscustom

limitinteger

El número de resultados que se van a devolver.

Default:1000

datestring (date)

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

search_volume_typestring

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.

Valores permitidos:ask_volumekeyword_volume

Default:ask_volume

tracked_urlsarray<string>

Una lista de URL de páginas seguidas. Cuando se proporciona, la respuesta incluye filas con cero citas para cualquier URL seguida que no tenga datos.

Mín.:1

tags_filterobject

Una expresión de filtro para etiquetas de prompt. Requiere report_id. Usa la sintaxis de filtros con las siguientes restricciones: el único nombre de campo válido es "tag"; los únicos operadores válidos son: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; la profundidad máxima de anidamiento de and y or es 2.

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

brand_filterobject

Una expresión de filtro para la visibilidad de tu marca, que reproduce el filtro “Tu marca”. brand_name coincide en función de si una respuesta menciona tu marca: "mentioned" o "not_mentioned". page_status coincide según el uso que hizo la IA de tus páginas: "cited" (la IA recuperó páginas de tu sitio y las citó en la respuesta), "found_but_not_cited" (la IA recuperó páginas de tu sitio como posibles fuentes, pero no las citó en la respuesta final) o "not_found" (la IA no recuperó ninguna página de tu sitio).
Usa la sintaxis de filtros con las siguientes restricciones: el único operador válido es "eq"; cada campo es una sección: proporciona un único valor o combina varios valores del mismo campo con or; une las secciones brand_name y page_status con un and/or de nivel superior. Se rechaza seleccionar todos los valores de un campo, ya que coincide con todo (en su lugar, omite el campo).

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

El intervalo de volumen por el que filtrar.

frominteger

tointeger

outputstring

El formato de salida.

Valores permitidos:jsonphp

Respuestas

pagesarray<object>

mentionsarray<object>

Obsoleto a partir del 2026-02-10.

responsesinteger

El número de respuestas que citaron la página.

urlstring

La URL de la página citada.

volumeinteger

Obsoleto a partir del 2026-03-24.

curl "https://api.ahrefs.com/v3/brand-radar/cited-pages" \ -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", "search_volume_type": "ask_volume", "tracked_urls": ["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" }'