Registro de Cambios de la API

​

23 de octubre de 2026

​

Cambiado

• Fechas de deprecación: Las operaciones, los parámetros y los campos deprecados de la API pública ahora incluyen la fecha en que se marcaron como deprecados. Las fechas siguientes son el momento en que cada elemento se marcó por primera vez en la especificación OpenAPI pública.
  • POST /public/v1/toptimize/forecasting/campaign — 2026-08-06. Use POST /public/v1/toptimize/forecasting/campaigns/listing.
  • DELETE /public/v1/media-service/slots/{slot_id}/fallback — 2026-09-10. El endpoint siempre responde 403. Gestione los fallbacks de banner en el dashboard de Topsort.
  • sort_by_date en GET /public/v1/campaign-service/campaigns — 2025-06-19. Use order_by.
  • amountRemaining, amountCarryover y amountUsed en budget — 2025-12-19.
  • bidCount en las respuestas de campañas — 2025-12-19.
  • externalVendorId en las respuestas de campañas — 2022-11-30. Use vendorId.
  • campaignBehaviorData y campaignBehaviorDataByDay en las respuestas de campañas — 2023-08-31.
  • bidsBehaviorData en las respuestas de pujas — 2023-09-22.
  • parentId en las categorías — 2026-02-09. Use path.
  • ean en productos y actualizaciones parciales de productos — 2026-08-06. Use gtin.

​

16 de octubre de 2026

​

Agregado

• Exportaciones asíncronas: Elija y combine las dimensiones y métricas compatibles, incluidas opciones nuevas que no estaban disponibles en los endpoints de reporting anteriores. Exporte conjuntos de datos más grandes como un único archivo Parquet de hasta 1 GiB, con ventanas de hasta 31 días y datos de hasta 120 días atrás. Las exportaciones se ejecutan en segundo plano: solicite una exportación, reciba un ID y descargue el archivo cuando esté listo. Consulte Exportaciones de datos personalizadas.
  • /public/v1/export-service/exports (POST)
  • /public/v1/export-service/datasets (GET)
  • /public/v1/export-service/exports/{export_id} (GET)

​

9 de octubre de 2026

​

Cambiado

• Respuestas de presupuesto de campañas: amountRemaining, amountCarryover y amountUsed en los objetos budget de las campañas están deprecados. El 19 de octubre de 2026, estos campos se eliminarán por completo de las respuestas. amount y type no cambian. El mismo objeto budget se devuelve en las campañas de sponsored brand. Consulte la referencia de Get campaigns.

​

Cambiado

• Colecciones de Assets API: Los cinco endpoints beta de colecciones que se indican a continuación están deprecados desde el 18 de agosto de 2026. Siguen funcionando como antes hasta su eliminación el 27 de agosto de 2026; después de esa fecha, las solicitudes a estos endpoints fallarán. Los endpoints de assets individuales no se ven afectados. Consulte la referencia de Assets API.
  • /public/v1/assets/collection (POST)
  • /public/v1/assets/collections (GET)
  • /public/v1/assets/collection/{collection-id} (GET, PATCH, DELETE)

​

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. 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).

​

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.

​

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).

​

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.

​

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.

​

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.

​

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

​

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.

​

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.

​

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.

​

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.

​

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.