> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registro de Cambios de la API

> Actualizaciones y cambios de la API

## Actualizaciones y cambios de la API para 2026

<Update label="Abril 2026" description="2026-04-16">
  ### Cambiado

  * **Respuestas de campañas:** `promotionType` está marcado como deprecado desde el 21 de noviembre de 2024; utilice `adFormat` en las respuestas de campañas y `formatProperties` en las respuestas de pujas en su lugar. Consulte la referencia de [Get campaigns](/es/api-reference/campaign-api/get-campaigns#response-campaigns-items-promotion-type). A partir del 23 de abril de 2026, `promotionType` se devolverá como `null`; la eliminación de solicitudes y respuestas está planificada para el 30 de abril de 2026 (sujeto a confirmación).
</Update>

## Actualizaciones y cambios de la API para 2025

<Update label="Diciembre 2025" description="2025-12-01 a 2025-12-31">
  ### Eliminado

  * `/public/v1/campaign-service/estimated-clicks` fue eliminado después de 1 año de desaprobación. No ha recibido tráfico durante 7 meses.
</Update>

<Update label="Noviembre 2025" description="2025-11-03 a 2025-11-26">
  ### Agregado

  * Endpoint `/public/v1/offsite-ads/audiences/user-list` para gestionar audiencias de lista de usuarios en anuncios offsite.

  ### Cambiado

  * `/v2/auctions`: Se agregó el campo `filter` con esquema `AttributesFilter` para filtrado de atributos de productos (soporta operadores `and`/`or` con array de atributos).
</Update>

<Update label="Septiembre 2025" description="2025-09-03 a 2025-09-16">
  ### Cambiado

  * `/v2/auctions`: Se agregó el objeto `page` a las solicitudes de subastas de listings patrocinados y banners.
  * `/v2/auctions/sponsored-brand`: Se agregó el campo opcional `page` a la solicitud.
</Update>

<Update label="Agosto 2025" description="2025-08-12 a 2025-08-28">
  ### Agregado

  * Endpoints `/public/v1/campaign-service/campaigns/exclusive-banner` (POST) y `/public/v1/campaign-service/campaigns/exclusive-banner/{campaign-id}` (GET, PATCH) para gestión de campañas de banners exclusivos.
  * Endpoints `/public/v1/campaign-service/campaigns/exclusive-listing` (POST) y `/public/v1/campaign-service/campaigns/exclusive-listing/{campaign-id}` (GET, PATCH) para gestión de campañas de listings exclusivos.
  * Endpoint `/public/v1/media-service/slots/{slot-id}` con métodos DELETE y PATCH para gestión de slots individuales.
  * Método POST agregado a `/public/v1/offsite-ads/audiences` para crear trabajos de audiencia.
</Update>

<Update label="Julio 2025" description="2025-07-01 a 2025-07-15">
  ### Agregado

  * Endpoints `/public/v1/campaign-service/json-templates` (GET, POST) y `/public/v1/campaign-service/json-templates/{json-template-id}` (GET, PATCH) para gestionar plantillas JSON de campañas.
  * Endpoint `/public/v1/media-service/slots` (GET, POST) para listar y crear slots de medios.
  * Endpoint `/public/v1/media-service/slots/{slot-id}/fallback` (DELETE) para configurar el comportamiento de respaldo del slot.
  * Endpoint `/public/v1/offsite-ads/audiences` (GET) para listar audiencias en anuncios offsite.
  * Método DELETE agregado a `/public/v1/campaign-service/campaigns/{campaign-id}/bids` para eliminar todas las pujas.
</Update>

<Update label="Junio 2025" description="2025-06-11 a 2025-06-30">
  ### Agregado

  * Endpoint `/public/v1/toppie/reporting/file-reports/daily-kpis-by-product` (GET) para exportar KPIs diarios por producto.
  * Endpoint `/public/v1/campaign-service/campaigns/{campaign-id}/products` (GET, PUT) para gestionar productos dentro de una campaña.
  * Endpoints públicos de API de anuncios offsite bajo `/public/v1/offsite-ads`
</Update>

<Update label="Mayo 2025" description="2025-05-01 a 2025-05-30">
  ### Agregado

  * Endpoints `/public/v1/toptimize/forecasting/campaign` (POST), `/public/v1/toptimize/forecasting/inventory` (POST) y `/public/v1/toptimize/forecasting/marketplace` (GET) para pronóstico de campañas e inventario.
</Update>

<Update label="Abril 2025" description="2025-04-01 a 2025-04-30">
  ### Agregado

  * Endpoints beta de Offsite Ads (`/v2/offsite-ads/`)
  * Endpoint beta `/toptimize/v1/predictions` para predicciones de CTR/CVR.
  * Endpoint beta `/toptimize/v1/retrieval` para recuperación de objetos.
  * Endpoint `/public/v1/segment-service/segments/{segment-id}/upload` (POST) para cargar datos de segmentos.
  * Endpoints `/public/v1/campaign-service/campaigns/{campaign-id}/restrictions` (GET, POST) y `/public/v1/campaign-service/campaigns/{campaign-id}/restrictions/{restriction-id}` (PATCH) para gestión de restricciones de campañas.
  * Endpoints `/public/v1/campaign-service/restriction-types` (GET) y `/public/v1/campaign-service/restriction-types/{restriction-type-id}` (GET) para gestionar definiciones de tipos de restricción.
  * Endpoint `/public/v1/reporting-service/file-reports/scored-attribution` (GET) para reportes de archivos de atribución ponderada.
  * Endpoint `/public/v1/reporting-service/file-reports/interactions` (GET) para exportar datos de interacciones.
  * Método DELETE agregado a `/public/v1/toppie/campaigns/{campaign-id}` para eliminar campañas.

  ### Cambiado

  * Events: Se agregaron referencias faltantes para mostrar el nuevo objeto pageview.
  * `/v2/events`: Se agregaron campos opcionales `deviceType` y `channel` para impresiones, clics, compras y pageviews.
</Update>

<Update label="Marzo 2025" description="2025-03-03 a 2025-03-26">
  ### Agregado

  * Endpoint beta `/toptimize/v1/rank` para clasificar objetos.
  * Endpoints `/public/v1/segment-service/segments` (GET, PUT) y `/public/v1/segment-service/segments/{segment-id}` (DELETE) para gestión de segmentos.
  * Endpoint `/public/v1/segment-service/segments/{segment-id}/signed-url` (GET) para obtener URLs firmadas para cargas de segmentos.
  * Endpoint `/public/v1/toppie/products` (GET) para listar productos de vendedores en Toppie.
  * Endpoint `/public/v1/reporting-service/interactions` (GET) para consultar datos de interacciones.
  * Endpoint `/public/v1/toppie/account/balance` (GET) para ver el saldo de la cuenta.
  * Endpoint `/public/v1/toppie/account/topups` (GET) para ver las recargas de la cuenta.
  * Endpoint `/public/v1/billing-service/campaign-billing-contact` (GET, PUT).
  * Endpoints `/public/v1/billing-service/billing-contacts` (GET) y `/public/v1/billing-service/billing-contacts/{billing-contact-id}` (GET, PUT) para gestión de contactos de facturación a nivel de mercado.
  * Endpoints `/public/v1/billing-service/vendor-billing-contact` (PUT) y `/public/v1/billing-service/vendors/{external-vendor-id}/vendor-billing-contact/{billing-contact-id}` (DELETE) para contactos de facturación a nivel de vendedor.
  * Método PATCH agregado a `/public/v1/toppie/campaigns/{campaign-id}` para actualizar campañas.

  ### Cambiado

  * `/v2/auctions/sponsored-brand`: Se agregaron campos opcionales `opaqueUserId` y `vendorId`.
  * Events: Se agregó ejemplo de seguimiento de ubicación para análisis de carrusel.
  * `/v2/auctions/travel`: Extendido para soportar **vuelos** además de hoteles.
</Update>

<Update label="Febrero 2025" description="2025-02-04 a 2025-02-26">
  ### Agregado

  * Endpoints `/public/v1/toppie/campaigns` (GET, POST) y `/public/v1/toppie/campaigns/{campaign-id}` (GET) para gestión de campañas de Toppie.
  * Endpoint `/public/v1/toppie/campaigns/{campaign-id}/bids` (GET) para gestionar pujas de campañas.
  * Endpoints de reportes de Toppie (`/public/v1/toppie/reporting`)
  * Endpoints `/public/v1/billing-service/vendors/{external-vendor-id}/wallets` (GET, POST) y `/public/v1/billing-service/vendors/{external-vendor-id}/wallets/{wallet-id}/adjust` (POST) para gestión de billeteras de vendedores.
  * Método PATCH agregado a `/public/v1/catalog-search-service/catalogs/products` para actualizar productos.

  ### Cambiado

  * Events: Se documentó que la atribución halo requiere `vendorId`.
</Update>

<Update label="Enero 2025" description="2025-01-06 a 2025-01-28">
  ### Agregado

  * Endpoint `/v2/auctions/travel` para subastas de viajes de hoteles.
  * Endpoint beta `/v2/events/beta/link-users` para vincular cuentas de usuario.
  * Endpoints `/public/v1/reporting-service/marketplace/campaigns-kpis` (GET) y `/public/v1/reporting-service/marketplace/vendors-kpis` (GET) para reportes de KPIs a nivel de mercado.
</Update>