Resumen - Impresiones
API + MCPLas 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
La expresión de filtro. Se reconocen los siguientes identificadores de columna (esto difiere de los identificadores reconocidos por el parámetro select).
Una lista de campos para devolver.
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"]}]}.
Una lista de códigos de país de dos letras (ISO 3166-1 alfa-2).
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#/...
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.
Una lista de modelos de chatbot. 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.
Una lista 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.
Una lista de nombres de competidores y sitios web que se deben buscar.
names or url_groups is requiredLos nombres de la marca o del competidor
El dominio del objetivo
El alcance del objetivo.
Una lista de nombres de marcas y sitios web que se deben buscar.
names or url_groups is requiredLos nombres de la marca o del competidor
El dominio del objetivo
El alcance del objetivo.
El formato de salida.
Respuestas
Nombre de la marca (ya sea su marca o la de un competidor incluido en la solicitud).
Impresiones estimadas de respuestas relacionadas con el mercado especificado que no mencionan ninguna de las marcas proporcionadas (el valor es cero cuando no se especifica market).
Impresiones estimadas de respuestas que mencionan únicamente marcas de competidores.
Impresiones estimadas de respuestas que mencionan únicamente su marca.
Impresiones estimadas de respuestas que mencionan tanto su marca como marcas de competidores.
Total de impresiones estimadas de su marca (incluye only_target_brand y target_and_competitors_brands).