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

# Histórico de Alterações da API

> Atualizações e alterações da API

## Atualizações e alterações da API para 2026

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

  * **Respostas de campanhas:** `promotionType` está marcado como depreciado desde 21 de novembro de 2024; utilize `adFormat` nas respostas de campanhas e `formatProperties` nas respostas de lances em vez disso. Consulte a referência de [Get campaigns](/pt/api-reference/campaign-api/get-campaigns#response-campaigns-items-promotion-type). A partir de 23 de abril de 2026, `promotionType` será retornado como `null`; a remoção de solicitações e respostas está planejada para 30 de abril de 2026 (sujeito a confirmação).
</Update>

## Atualizações e alterações da API para 2025

<Update label="Dezembro de 2025" description="2025-12-01 a 2025-12-31">
  ### Removido

  * `/public/v1/campaign-service/estimated-clicks` foi removido após 1 ano de descontinuação. Não recebeu tráfego por 7 meses.
</Update>

<Update label="Novembro de 2025" description="2025-11-03 a 2025-11-26">
  ### Adicionado

  * Endpoint `/public/v1/offsite-ads/audiences/user-list` para gerenciar públicos de lista de usuários em anúncios fora do site.

  ### Alterado

  * `/v2/auctions`: Campo `filter` adicionado com esquema `AttributesFilter` para filtragem de atributos de produto (suporta operadores `and`/`or` com array de atributos).
</Update>

<Update label="Setembro de 2025" description="2025-09-03 a 2025-09-16">
  ### Alterado

  * `/v2/auctions`: Objeto `page` adicionado às solicitações de leilão de listagens patrocinadas e banners.
  * `/v2/auctions/sponsored-brand`: Campo opcional `page` adicionado à solicitação.
</Update>

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

  * Endpoints `/public/v1/campaign-service/campaigns/exclusive-banner` (POST) e `/public/v1/campaign-service/campaigns/exclusive-banner/{campaign-id}` (GET, PATCH) para gerenciamento de campanhas de banner exclusivo.
  * Endpoints `/public/v1/campaign-service/campaigns/exclusive-listing` (POST) e `/public/v1/campaign-service/campaigns/exclusive-listing/{campaign-id}` (GET, PATCH) para gerenciamento de campanhas de listagem exclusiva.
  * Endpoint `/public/v1/media-service/slots/{slot-id}` com métodos DELETE e PATCH para gerenciamento individual de slot.
  * Método POST adicionado a `/public/v1/offsite-ads/audiences` para criar trabalhos de público.
</Update>

<Update label="Julho de 2025" description="2025-07-01 a 2025-07-15">
  ### Adicionado

  * Endpoints `/public/v1/campaign-service/json-templates` (GET, POST) e `/public/v1/campaign-service/json-templates/{json-template-id}` (GET, PATCH) para gerenciar modelos JSON de campanha.
  * Endpoint `/public/v1/media-service/slots` (GET, POST) para listar e criar slots de mídia.
  * Endpoint `/public/v1/media-service/slots/{slot-id}/fallback` (DELETE) para configurar comportamento de fallback do slot.
  * Endpoint `/public/v1/offsite-ads/audiences` (GET) para listar públicos em anúncios fora do site.
  * Método DELETE adicionado a `/public/v1/campaign-service/campaigns/{campaign-id}/bids` para excluir todos os lances.
</Update>

<Update label="Junho de 2025" description="2025-06-11 a 2025-06-30">
  ### Adicionado

  * Endpoint `/public/v1/toppie/reporting/file-reports/daily-kpis-by-product` (GET) para exportar KPIs diários por produto.
  * Endpoint `/public/v1/campaign-service/campaigns/{campaign-id}/products` (GET, PUT) para gerenciar produtos dentro de uma campanha.
  * Endpoints públicos de API de anúncios fora do site em `/public/v1/offsite-ads`
</Update>

<Update label="Maio de 2025" description="2025-05-01 a 2025-05-30">
  ### Adicionado

  * Endpoints `/public/v1/toptimize/forecasting/campaign` (POST), `/public/v1/toptimize/forecasting/inventory` (POST) e `/public/v1/toptimize/forecasting/marketplace` (GET) para previsão de campanha e inventário.
</Update>

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

  * Endpoints beta de Anúncios Fora do Site (`/v2/offsite-ads/`)
  * Endpoint beta `/toptimize/v1/predictions` para previsões de CTR/CVR.
  * Endpoint beta `/toptimize/v1/retrieval` para recuperação de objetos.
  * Endpoint `/public/v1/segment-service/segments/{segment-id}/upload` (POST) para upload de dados de segmento.
  * Endpoints `/public/v1/campaign-service/campaigns/{campaign-id}/restrictions` (GET, POST) e `/public/v1/campaign-service/campaigns/{campaign-id}/restrictions/{restriction-id}` (PATCH) para gerenciamento de restrições de campanha.
  * Endpoints `/public/v1/campaign-service/restriction-types` (GET) e `/public/v1/campaign-service/restriction-types/{restriction-type-id}` (GET) para gerenciar definições de tipos de restrição.
  * Endpoint `/public/v1/reporting-service/file-reports/scored-attribution` (GET) para relatórios de arquivo de atribuição pontuada.
  * Endpoint `/public/v1/reporting-service/file-reports/interactions` (GET) para exportar dados de interação.
  * Método DELETE adicionado a `/public/v1/toppie/campaigns/{campaign-id}` para excluir campanhas.

  ### Alterado

  * Eventos: Referências ausentes adicionadas para exibir novo objeto pageview.
  * `/v2/events`: Campos opcionais `deviceType` e `channel` adicionados para impressões, cliques, compras e pageviews.
</Update>

<Update label="Março de 2025" description="2025-03-03 a 2025-03-26">
  ### Adicionado

  * Endpoint beta `/toptimize/v1/rank` para classificar objetos.
  * Endpoints `/public/v1/segment-service/segments` (GET, PUT) e `/public/v1/segment-service/segments/{segment-id}` (DELETE) para gerenciamento de segmentos.
  * Endpoint `/public/v1/segment-service/segments/{segment-id}/signed-url` (GET) para obter URLs assinadas para uploads de segmento.
  * Endpoint `/public/v1/toppie/products` (GET) para listar produtos de fornecedor no Toppie.
  * Endpoint `/public/v1/reporting-service/interactions` (GET) para consultar dados de interação.
  * Endpoint `/public/v1/toppie/account/balance` (GET) para visualizar saldo da conta.
  * Endpoint `/public/v1/toppie/account/topups` (GET) para visualizar recargas da conta.
  * Endpoint `/public/v1/billing-service/campaign-billing-contact` (GET, PUT).
  * Endpoints `/public/v1/billing-service/billing-contacts` (GET) e `/public/v1/billing-service/billing-contacts/{billing-contact-id}` (GET, PUT) para gerenciamento de contato de faturamento em nível de marketplace.
  * Endpoints `/public/v1/billing-service/vendor-billing-contact` (PUT) e `/public/v1/billing-service/vendors/{external-vendor-id}/vendor-billing-contact/{billing-contact-id}` (DELETE) para contatos de faturamento em nível de fornecedor.
  * Método PATCH adicionado a `/public/v1/toppie/campaigns/{campaign-id}` para atualizar campanhas.

  ### Alterado

  * `/v2/auctions/sponsored-brand`: Campos opcionais `opaqueUserId` e `vendorId` adicionados.
  * Eventos: Exemplo de rastreamento de posicionamento adicionado para análise de carrossel.
  * `/v2/auctions/travel`: Estendido para suportar **voos** além de hotéis.
</Update>

<Update label="Fevereiro de 2025" description="2025-02-04 a 2025-02-26">
  ### Adicionado

  * Endpoints `/public/v1/toppie/campaigns` (GET, POST) e `/public/v1/toppie/campaigns/{campaign-id}` (GET) para gerenciamento de campanhas Toppie.
  * Endpoint `/public/v1/toppie/campaigns/{campaign-id}/bids` (GET) para gerenciar lances de campanha.
  * Endpoints de relatórios Toppie (`/public/v1/toppie/reporting`)
  * Endpoints `/public/v1/billing-service/vendors/{external-vendor-id}/wallets` (GET, POST) e `/public/v1/billing-service/vendors/{external-vendor-id}/wallets/{wallet-id}/adjust` (POST) para gerenciamento de carteira de fornecedor.
  * Método PATCH adicionado a `/public/v1/catalog-search-service/catalogs/products` para atualizar produtos.

  ### Alterado

  * Eventos: Documentado que atribuição halo requer `vendorId`.
</Update>

<Update label="Janeiro de 2025" description="2025-01-06 a 2025-01-28">
  ### Adicionado

  * Endpoint `/v2/auctions/travel` para leilões de viagens de hotel.
  * Endpoint beta `/v2/events/beta/link-users` para vincular contas de usuário.
  * Endpoints `/public/v1/reporting-service/marketplace/campaigns-kpis` (GET) e `/public/v1/reporting-service/marketplace/vendors-kpis` (GET) para relatórios de KPI em nível de marketplace.
</Update>