Docs
Buscar documentación...⌘K

Historial del resumen - Menciones

API + MCP
POST/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.

Cuerpo de la solicitud

whereobject

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 utilizó para generar la respuesta.
tipo: dominio

cited_domain_subdomains: El dominio de una página que se utilizó 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 utilizó para generar la respuesta.
tipo: string

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

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

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

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

topic: El tema de la consulta.
tipo: string

tags_filterobject

Una expresión de filtro para las etiquetas del prompt. Requiere report_id. Utiliza la sintaxis de filtro 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. Ejemplo: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

date_tostring

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

date_fromstringRequired

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

countryarray<string>

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

Allowed values: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.

Allowed values:ahrefscustom
data_sourcearray<string>Required

Una lista de modelos de chatbot. Los modelos de Google (google_ai_overviews, google_ai_mode) no se pueden combinar entre sí ni con modelos que no sean de Google.

Allowed values:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok
marketarray<string>

Una lista de los nichos de mercado de tus marcas.

brandsarray<object>

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

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>
targetstringrequired

El dominio del objetivo

Example:ahrefs.com
scopestringrequired

El alcance del objetivo.

Allowed values:urlpathdomainsubdomains
outputstring

El formato de salida.

Allowed values:jsoncsvxmlphp

Respuestas

metricsarray<object>
datestring
mentionsinteger

Menciones estimadas a partir de respuestas que mencionan la marca.