Registro de cambios

​

Agregado

• Se agregó el sentimiento de citas a nivel de página a POST /v2/reports/sentiment con source: "citation". Las filas de citas incluyen sentimiento positivo, sentimiento negativo, cuota de citas equilibrada por modelo y posición; se pueden ordenar por cuota de citas o por sentimiento positivo.
• Se agregaron los filtros citation_category (is/in) y de búsqueda por página normalizada (page con contains_case_insensitive) para el sentimiento de citas. El modo de citas es solo por página y admite tanto la paginación por cursor como la variante SSE /stream; no admite group_by.
• Nuevos endpoints de Prompt Volumes: Keyword Volume (POST /v2/prompt-volumes/volume/on-the-fly) para proyecciones de volumen semanales y mensuales de una palabra clave, y Keyword Intent Shares (POST /v2/prompt-volumes/intents/on-the-fly) para la combinación de intenciones detrás de ella.

​

Agregado

• Nuevos informes sociales de YouTube en beta: Query YouTube Channels y Query YouTube Videos para agregados por canal, clasificaciones de videos citados y modos de atribución.
• Nuevo endpoint: Get Citation Tags - Las etiquetas de citas personalizadas definidas para una categoría, como { value, name } por etiqueta. Pasa cualquiera de estos valores al nuevo filtro citation_tag que se describe a continuación.
• Nuevo filtro citation_tag en POST /v2/reports/citations - Limita un informe de citas a las URL que tienen una o más de tus etiquetas personalizadas (is/in; los valores dentro de una misma hoja in se combinan con OR).

​

Agregado

• Nuevo endpoint: Get Citation Categories - Las opciones de filtro de categoría de citas para una categoría: los grupos integrados (Owned, Competition, Earned Media, Institution, PR Wire, Social, Other) más cualquier categoría personalizada.

​

Agregado

• Nuevos endpoints /v2/reports en beta: una estructura unificada de solicitud/respuesta { info, data }, que acepta nombres o UUID en los filtros, con paginación por cursor y una variante /stream (SSE):
  • POST /v2/reports/visibility - Visibilidad de activos, cuota de voz y posición promedio
  • POST /v2/reports/citations - Recuentos, cuota y posición de citas por dominio y página
  • POST /v2/reports/sentiment - Sentimiento positivo/negativo por marca con periodos de comparación opcionales
  • POST /v2/reports/query-fanouts - Consultas de búsqueda que una IA genera internamente al responder un prompt
  • POST /v2/reports/factcheck - Puntuaciones de FactCheck, con una variante /stream (SSE)
  • POST /v2/reports/factcheck/claims - Afirmaciones inexactas de FactCheck, con una variante /stream (SSE)
• Nuevo endpoint en beta: POST /v2/prompts/answers - Filas sin procesar por ejecución (menciones, citas, consultas de búsqueda), con una variante /stream (SSE)

​

Obsoleto

• Los endpoints de informes V1 (POST /v1/reports/visibility, /citations, /sentiment, /sentiment-v2, /query-fanouts) se están retirando gradualmente en favor de los equivalentes V2 anteriores. Siguen activos; se anunciará una fecha de retirada antes de su eliminación.

​

Agregado

• Nuevo endpoint: List Agents - Enumera los agentes disponibles para tu organización
• Nuevo endpoint: Get an Agent - Recupera un agente y los detalles de su esquema
• Nuevo endpoint: Run an Agent - Inicia una nueva ejecución de un agente
• Nuevo endpoint: Get an Agent Run - Recupera el estado y los detalles del resultado de una ejecución de agente

​

Obsoleto

• Endpoints sin procesar de Agent Analytics marcados como obsoletos:
  • POST /v1/logs/raw - Get Logs
  • POST /v1/logs/raw/bots - Get Bots
• La obsolescencia comenzó el 2026-04-10
• Las claves de API creadas a partir del 2026-04-10 ya no pueden acceder a estos endpoints
• Las claves de API existentes creadas antes del 2026-04-10 pueden seguir usando estos endpoints hasta la fecha de retirada, el 2026-06-10
• En su lugar, migra a los endpoints de informes agregados V2:
  • POST /v2/reports/bots para informes de tráfico de bots
  • POST /v2/reports/referrals para informes de tráfico de referencia
• Para ver ejemplos con los endpoints de reemplazo, consulta Agent Analytics V2

​

Agregado

• Nuevos endpoints /v2/reports con granularidad por hora, agrupados por hora UTC (consulta Agent Analytics V2)
  • POST /v2/reports/bots - Datos de tráfico de bots con resolución por hora
  • POST /v2/reports/referrals - Datos de tráfico de referencia con resolución por hora, incluida la distinción entre UTM y referente
• Como V2 usa grupos por hora UTC en lugar de grupos por día EST, los usuarios de cualquier zona horaria ahora pueden alinear las consultas con sus propios días naturales locales

​

Agregado

• Nuevo endpoint: Get Referrals Report - Recupera datos de tráfico de referencia de informes agregados diarios
• Nuevo endpoint: Get Bots Report - Recupera analíticas de tráfico de bots con métricas de citas, indexación, entrenamiento y número de visitas

​

Cambiado

• Se reorganizó la estructura de la documentación de ejemplos en la nueva pestaña Example Requests

​

Eliminado

• Página de ejemplos heredada

​

Agregado

• Nuevo endpoint: Get Personas - Recupera todas las personas asociadas a tu organización
• Nuevo endpoint: Get Category Personas - Recupera todas las personas asociadas a la categoría indicada
• Dimensión persona en los informes de citas, visibilidad y sentimiento
• persona en las respuestas a prompts
• model_id en las respuestas a prompts
• sentiment_themes en las respuestas a prompts, lo que deja obsoleto themes. sentiment_themes devuelve el tema y su sentimiento

​

Cambiado

• Se requiere un valor de lista no vacío al usar los operadores de filtro in o not_in
• No se permite deshabilitar el campo created_at

​

Corregido

• Se evita exportar prompts duplicados en las respuestas a prompts.

​

Agregado

• Nuevo endpoint: Get Category Assets - Recupera los activos asociados a una categoría específica
• Nuevo endpoint: Get Assets - Recupera todos los activos asociados a tu organización
• Dimensión asset_id en Query Visibility y Query Sentiment

​

Cambiado

• Se requiere incluir hostname, path, root_domain y url como dimensiones cuando se usan como filtros

​

Corregido

• El filtro contains no se aplicaba correctamente
• Error tipográfico en el nombre del campo de la métrica de sentimiento
  • Antes: ocurrences
  • Después: occurrences
• Los filtros que contenían UUID no se aplicaban correctamente
• Manejo incorrecto de valores mixtos con y sin zona horaria en los filtros start_date y end_date