> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Registro de cambios
> Nuevos endpoints, cambios, obsolescencias y correcciones en la REST API de Profound
## Descripción general
Este registro de cambios recoge todos los cambios, actualizaciones y mejoras de la API REST de Profound. Documentamos nuevas funcionalidades, correcciones de errores, cambios incompatibles, obsolescencias y actualizaciones de seguridad para ayudarte a mantenerte informado y planificar tus integraciones en consecuencia.
V2 ahora abarca los informes de Answer Engine Insights y Agent Analytics en
`/v2/reports/visibility`, `/v2/reports/citations`,
`/v2/reports/sentiment`, `/v2/reports/query-fanouts`,
`/v2/reports/factcheck` y `/v2/reports/factcheck/claims`, así como
`/v2/prompts/answers`; cada uno tiene una variante SSE `/stream`. Los endpoints V1
siguen activos, incluidos los endpoints de informes V1. Para obtener más información sobre
el control de versiones de la API, consulta la [Introducción](/es/rest-api/introduction#api-versioning).
## Categorías de cambios
Los cambios se organizan en las siguientes categorías:
* **Agregado** - Nuevos endpoints, funcionalidades o capacidades
* **Cambiado** - Modificaciones de endpoints o comportamientos existentes
* **Obsoleto** - Funcionalidades que se eliminarán en una versión futura
* **Eliminado** - Funcionalidades que se han eliminado
* **Corregido** - Correcciones de errores
* **Seguridad** - Mejoras de seguridad y parches de vulnerabilidades
* **Incompatible** - Cambios que requieren acción para mantener la compatibilidad
### Agregado
* Se agregó el sentimiento de citas a nivel de página a [`POST /v2/reports/sentiment`](/es/rest-api/reports/query-sentiment-v2) 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](/es/rest-api/prompt-volumes/query-volume-v2) (`POST /v2/prompt-volumes/volume/on-the-fly`) para proyecciones de volumen semanales y mensuales de una palabra clave, y [Keyword Intent Shares](/es/rest-api/prompt-volumes/query-intents-v2) (`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](/es/rest-api/reports/query-youtube-channels-v2) y [Query YouTube Videos](/es/rest-api/reports/query-youtube-videos-v2) para agregados por canal, clasificaciones de videos citados y modos de atribución.
* Nuevo endpoint: [Get Citation Tags](/api-reference/organization/get-category-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`](/es/rest-api/reports/query-citations-v2) - 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](/api-reference/organization/get-category-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](/api-reference/agents/list-agents) - Enumera los agentes disponibles para tu organización
* Nuevo endpoint: [Get an Agent](/api-reference/agents/get-an-agent) - Recupera un agente y los detalles de su esquema
* Nuevo endpoint: [Run an Agent](/api-reference/agents/run-an-agent) - Inicia una nueva ejecución de un agente
* Nuevo endpoint: [Get an Agent Run](/api-reference/agents/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](/es/rest-api/examples/agent-analytics)
### Agregado
* Nuevos endpoints `/v2/reports` con **granularidad por hora**, agrupados por hora UTC (consulta [Agent Analytics V2](/es/rest-api/examples/agent-analytics))
* `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](/api-reference/reports/get-referrals-report-v1) - Recupera datos de tráfico de referencia de informes agregados diarios
* Nuevo endpoint: Get [Bots Report](/api-reference/reports/get-bots-report-v1) - 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](/es/rest-api/examples/example)
### Eliminado
* Página de ejemplos heredada
### Agregado
* Nuevo endpoint: [Get Personas](/api-reference/organization/get-personas) - Recupera todas las personas asociadas a tu organización
* Nuevo endpoint: [Get Category Personas](/api-reference/organization/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](/api-reference/organization/get-category-assets) - Recupera los activos asociados a una categoría específica
* Nuevo endpoint: [Get Assets](/api-reference/organization/get-assets) - Recupera todos los activos asociados a tu organización
* Dimensión `asset_id` en [Query Visibility](/api-reference/reports/query-visibility) y [Query Sentiment](/api-reference/reports/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`