Respuestas de IA
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
Una lista de campos separados por comas que se devolverán.
La expresión de filtro. Se reconocen los siguientes identificadores de columna (esto difiere de los identificadores reconocidos por el parámetro select).
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#/...
Una lista de marcas que buscar, separadas por comas. Como mínimo, uno de brand, competitors, market o where no debe estar vacío.
Una lista de competidores de tus marcas separados por comas.
Una lista separada por comas de modelos de chatbot. Todos los modelos pueden combinarse 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 de AI Overviews / modo IA derivada de consultas de búsqueda de Google (palabras clave) y no de prompts.
Una lista separada por comas de códigos de país de dos letras (ISO 3166-1 alpha-2).
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.
El número de resultados que se van a devolver.
La fecha que se buscará, en formato YYYY-MM-DD.
Una fecha para comparar con date, en formato YYYY-MM-DD. Debe ser estrictamente anterior a date. Cuando se establece, el informe abarca todos los prompts respondidos en cualquiera de las dos fechas y el campo status informa de cómo cambió cada uno entre ellas. Un prompt respondido solo en date_compared se informa como lost, y el resto de sus campos describen su respuesta de date_compared, ya que no tiene ninguna en date.
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.
Una columna por la que ordenar los resultados.
El formato de salida.
Respuestas
El país de la pregunta.
El modelo de chatbot que generó la respuesta.
La fecha en la que los datos se actualizaron por última vez.
(10 unidades) Los enlaces utilizados para la respuesta.
La pregunta formulada por el usuario.
(10 unidades) La respuesta del modelo.
La consulta de búsqueda utilizada por el chatbot para encontrar información para la respuesta. Nota: si data_source no incluye chatgpt o perplexity, este campo siempre estará vacío.
Cómo cambió el prompt entre date_compared y date. Nulo a menos que se establezca date_compared. new — respondido en date pero no en date_compared. lost — respondido en date_compared pero no en date; el resto de esta fila describe la respuesta de date_compared, ya que no hay ninguna en date. no_change — respondido en ambas fechas, lo cual no dice nada sobre si cambiaron la respuesta en sí, sus menciones o sus citas.
Etiquetas asignadas a la consulta.
(10 unidades) Volumen de búsqueda mensual estimado. Se basa en nuestras estimaciones para Google, combinando los volúmenes de búsqueda de palabras clave relacionadas en las que esta pregunta aparece en la sección People Also Ask.