Historial del resumen - Menciones

API + MCP

GET/v3/brand-radar/mentions-history

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

wherestring

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

cited_domain: El dominio de una página que se usó para generar la respuesta.
tipo: domain

cited_domain_subdomains: El dominio de una página que se usó para generar la respuesta. También coincidirá cualquier subdominio del dominio indicado.
tipo: string

cited_url_exact: La URL de una página que se usó para generar la respuesta.
tipo: string

cited_url_prefix: La URL de una página que se usó para generar la respuesta. Coincidirá cualquier URL que empiece por este prefijo.
tipo: string

question: La pregunta formulada por el usuario.
tipo: string

response (10 unidades): La respuesta del modelo.
tipo: string

search_queries: La consulta de búsqueda que usó el chatbot para encontrar información para la respuesta. Nota: si data_source no incluye chatgpt o perplexity, este campo siempre estará vacío.
tipo: string

topic: El tema de la consulta.
tipo: string

date_tostring (date)

La fecha de finalización del periodo histórico en formato AAAA-MM-DD.

date_fromstring (date)Obligatorio

La fecha de inicio del periodo histórico en formato AAAA-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 usará. Si se proporciona uno, el resto de parámetros se toman del informe (mercado, país, filtros). Si se proporcionan el país o los filtros, prevalecerán 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#/...

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.

brandstringObligatorio

La marca que se buscará.

outputstring

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Respuestas

metricsarray<object>

datestring (date)

mentionsinteger

Menciones estimadas a partir de respuestas que mencionan la marca.