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.
Cuerpo de la solicitud
Una lista de columnas que se devolverán. Consulta el Schema de respuesta para ver los identificadores de columna válidos.
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
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"]}]}.
El número de resultados que se devolverán.
La fecha que se debe buscar en formato YYYY-MM-DD.
Una lista de códigos de país de dos letras (ISO 3166-1 alfa-2).
Una columna por la que ordenar los resultados.
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 Google (google_ai_overviews, google_ai_mode) no se pueden combinar entre sí ni con modelos que no sean de Google.
Una lista de los nichos de mercado de tus marcas.
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
El país de la pregunta.
El modelo de chatbot que generó la respuesta.
(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.
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.