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.
Parámetros de consulta
La expresión de filtro. Se reconocen los siguientes identificadores de columna (que son distintos de los identificadores reconocidos por el parámetro select).
Una lista de campos separados por comas para devolver.
Los informes de visibilidad de IA están migrando al volumen ajustado por IA. Permite estimar 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 31 de agosto de 2026; todas las solicitudes usarán el nuevo volumen ajustado por IA.
Una lista separada por comas 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 indica uno, los demás parámetros se toman del informe (marca, competidores, mercado, país, filtros). Si se especifican el país o los filtros, estos 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#/...
El tipo de prompts que se va a usar. Si no se especifica, se usarán ambos tipos. Los prompts personalizados requieren que se proporcione un report_id.
Una lista de modelos de chatbot separados por comas. 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.
Una lista separada por comas de los nichos de mercado de tus marcas. Este parámetro, obsoleto a partir del 2026-05-18, dejará de tener efecto poco después de esa fecha.
Una lista separada por comas de los competidores de tus marcas.
Una lista separada por comas de las marcas que se deben buscar. Al menos uno de los parámetros brand, competitors, market o where no debe estar vacío.
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).