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
Lista de campos 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 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
Ámbito del objetivo.
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
Ámbito del objetivo.
Frases opcionales usadas para incluir o excluir resultados según su contenido.
Mostrar solo resultados que contengan al menos una de estas frases exactas.
Ocultar resultados que contengan cualquiera de estas frases exactas.
Una lista de modelos de chatbot. 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 de códigos de país de dos letras (ISO 3166-1 alfa-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.
Cómo ordenar los resultados: por una columna o por cómo se refieren las respuestas a una marca, tal como permite hacer la página Sentimiento de Brand Radar.
Una columna para ordenar los resultados.
Una expresión de filtro para etiquetas de prompt. Requiere report_id. Usa la sintaxis de filtros 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.
Una expresión de filtro para la visibilidad de tu marca, que reproduce el filtro “Tu marca”. brand_name coincide en función de si una respuesta menciona tu marca: "mentioned" o "not_mentioned". page_status coincide según el uso que hizo la IA de tus páginas: "cited" (la IA recuperó páginas de tu sitio y las citó en la respuesta), "found_but_not_cited" (la IA recuperó páginas de tu sitio como posibles fuentes, pero no las citó en la respuesta final) o "not_found" (la IA no recuperó ninguna página de tu sitio).
Usa la sintaxis de filtros con las siguientes restricciones: el único operador válido es "eq"; cada campo es una sección: proporciona un único valor o combina varios valores del mismo campo con or; une las secciones brand_name y page_status con un and/or de nivel superior. Se rechaza seleccionar todos los valores de un campo, ya que coincide con todo (en su lugar, omite el campo).
El intervalo de volumen por el que filtrar.
Requiere date_compared. Mantiene solo los prompts que cambiaron de alguna de las formas seleccionadas aquí. Las tres columnas se combinan con OR entre sí, al igual que los valores dentro de cada columna, por lo que una columna omitida o vacía no añade nada al filtro y un objeto completamente vacío mantiene todos los prompts.
Mantén los prompts que se respondieron solo en una de las dos fechas (new, lost) o en ambas (no_change).
Mantén los prompts en los que el conjunto de tus propias marcas mencionadas en la respuesta incorporó una marca (new), perdió una (lost) o es idéntico en ambas fechas (no_change). No se tienen en cuenta los competidores.
Mantén los prompts en los que el conjunto de tus propios dominios citados por la respuesta incorporó un dominio (new), perdió uno (lost) o es idéntico en ambas fechas (no_change). No se tienen en cuenta los competidores.
Un filtro sobre cómo las respuestas hablan de tus marcas y competidores, como el filtro de sentimiento en Brand Radar. Usa la sintaxis de filtros con tres campos:
brand(obligatorio): un nombre debrandsocompetitors, con"eq".sentiment(opcional):positive,neutral,negativeomixed. Con"eq", la marca se menciona con este sentimiento. Con"neq", la marca se menciona con un sentimiento, pero nunca con este. Con"empty", la marca nunca se menciona con un sentimiento, lo que incluye respuestas que no la mencionan. Connot"empty", la marca se menciona con algún sentimiento. Sinsentiment, coincide cualquier respuesta que mencione la marca.aspect(opcional): sobre qué trata el sentimiento, con"eq":features_specs,performance_effectiveness,price_value,reputation_popularity,quality_reliability,design_comfort,usability_compatibility,availability_delivery,safety_health,service_supportogeneral.
Cada regla es sobre una marca: una condición, o unandde condiciones. Para combinar reglas, pon cada una en su propioandy únelas con unandoorde nivel superior.
Coloca las respuestas con una mención positiva, negativa o mixta de una marca rastreada antes que las demás; cada grupo, por relevancia, tal como las muestra la página Sentimiento de Brand Radar. Solo con order_by relevance.
El formato de salida.
Respuestas
Cada mención de una marca rastreada en la respuesta: primero tus marcas y después los competidores en su orden, junto con cómo habla la respuesta sobre ella.
La marca rastreada mencionada.
Cómo habla la respuesta de la marca en esta mención. Nulo cuando no está disponible.
De qué trata la mención, como el precio o la calidad. Nulo cuando no está disponible.
La frase alrededor de la mención. Nulo cuando no se puede encontrar en la respuesta.
El país de la pregunta.
El modelo de chatbot que generó la respuesta.
La fase del embudo del prompt. Nulo cuando no hay disponible ninguna fase del embudo.
Las etiquetas de intención del prompt, incluidas su intención principal, sus subtipos y sus atributos de marca o locales. Un array vacío significa que no hay etiquetas de intención disponibles.
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.