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

# API-Änderungsprotokoll

> API-Updates und Änderungen

## API-Updates und Änderungen für 2026

<Update label="April 2026" description="2026-04-16">
  ### Geändert

  * **Kampagnenantworten:** `promotionType` ist seit dem 21. November 2024 als veraltet markiert; verwenden Sie stattdessen `adFormat` in Kampagnenantworten und `formatProperties` in Gebotsantworten. Siehe die Referenz zu [Get campaigns](/de/api-reference/campaign-api/get-campaigns#response-campaigns-items-promotion-type). Ab dem 23. April 2026 wird `promotionType` als `null` zurückgegeben; die Entfernung aus Anfragen und Antworten ist für den 30. April 2026 geplant (vorbehaltlich Bestätigung).
</Update>

## API-Updates und Änderungen für 2025

<Update label="Dezember 2025" description="2025-12-01 bis 2025-12-31">
  ### Entfernt

  * `/public/v1/campaign-service/estimated-clicks` wurde nach 1 Jahr Deprecation entfernt. Es hat seit 7 Monaten keinen Traffic mehr erhalten.
</Update>

<Update label="November 2025" description="2025-11-03 bis 2025-11-26">
  ### Hinzugefügt

  * Endpoint `/public/v1/offsite-ads/audiences/user-list` zur Verwaltung von Benutzerlisten-Audiences in Offsite-Anzeigen.

  ### Geändert

  * `/v2/auctions`: `filter`-Feld mit `AttributesFilter`-Schema für die Filterung von Produktattributen hinzugefügt (unterstützt `and`/`or`-Operatoren mit Attribut-Array).
</Update>

<Update label="September 2025" description="2025-09-03 bis 2025-09-16">
  ### Geändert

  * `/v2/auctions`: `page`-Objekt zu Sponsored Listings- und Banner-Auktionsanfragen hinzugefügt.
  * `/v2/auctions/sponsored-brand`: Optionales `page`-Feld zur Anfrage hinzugefügt.
</Update>

<Update label="August 2025" description="2025-08-12 bis 2025-08-28">
  ### Hinzugefügt

  * Endpoints `/public/v1/campaign-service/campaigns/exclusive-banner` (POST) und `/public/v1/campaign-service/campaigns/exclusive-banner/{campaign-id}` (GET, PATCH) zur Verwaltung exklusiver Banner-Kampagnen.
  * Endpoints `/public/v1/campaign-service/campaigns/exclusive-listing` (POST) und `/public/v1/campaign-service/campaigns/exclusive-listing/{campaign-id}` (GET, PATCH) zur Verwaltung exklusiver Listing-Kampagnen.
  * Endpoint `/public/v1/media-service/slots/{slot-id}` mit DELETE- und PATCH-Methoden zur individuellen Slot-Verwaltung.
  * POST-Methode zu `/public/v1/offsite-ads/audiences` hinzugefügt, um Audience-Aufgaben zu erstellen.
</Update>

<Update label="Juli 2025" description="2025-07-01 bis 2025-07-15">
  ### Hinzugefügt

  * Endpoints `/public/v1/campaign-service/json-templates` (GET, POST) und `/public/v1/campaign-service/json-templates/{json-template-id}` (GET, PATCH) zur Verwaltung von Kampagnen-JSON-Templates.
  * Endpoint `/public/v1/media-service/slots` (GET, POST) zum Auflisten und Erstellen von Media-Slots.
  * Endpoint `/public/v1/media-service/slots/{slot-id}/fallback` (DELETE) zur Konfiguration des Slot-Fallback-Verhaltens.
  * Endpoint `/public/v1/offsite-ads/audiences` (GET) zum Auflisten von Audiences in Offsite-Anzeigen.
  * DELETE-Methode zu `/public/v1/campaign-service/campaigns/{campaign-id}/bids` hinzugefügt, um alle Gebote zu löschen.
</Update>

<Update label="Juni 2025" description="2025-06-11 bis 2025-06-30">
  ### Hinzugefügt

  * Endpoint `/public/v1/toppie/reporting/file-reports/daily-kpis-by-product` (GET) zum Export täglicher KPIs nach Produkt.
  * Endpoint `/public/v1/campaign-service/campaigns/{campaign-id}/products` (GET, PUT) zur Verwaltung von Produkten innerhalb einer Kampagne.
  * Öffentliche Offsite-Anzeigen-API-Endpoints unter `/public/v1/offsite-ads`
</Update>

<Update label="Mai 2025" description="2025-05-01 bis 2025-05-30">
  ### Hinzugefügt

  * Endpoints `/public/v1/toptimize/forecasting/campaign` (POST), `/public/v1/toptimize/forecasting/inventory` (POST) und `/public/v1/toptimize/forecasting/marketplace` (GET) für Kampagnen- und Bestandsprognosen.
</Update>

<Update label="April 2025" description="2025-04-01 bis 2025-04-30">
  ### Hinzugefügt

  * Beta Offsite-Anzeigen-Endpoints (`/v2/offsite-ads/`)
  * Beta-Endpoint `/toptimize/v1/predictions` für CTR/CVR-Vorhersagen.
  * Beta-Endpoint `/toptimize/v1/retrieval` für Objekt-Retrieval.
  * Endpoint `/public/v1/segment-service/segments/{segment-id}/upload` (POST) zum Hochladen von Segment-Daten.
  * Endpoints `/public/v1/campaign-service/campaigns/{campaign-id}/restrictions` (GET, POST) und `/public/v1/campaign-service/campaigns/{campaign-id}/restrictions/{restriction-id}` (PATCH) zur Verwaltung von Kampagnenbeschränkungen.
  * Endpoints `/public/v1/campaign-service/restriction-types` (GET) und `/public/v1/campaign-service/restriction-types/{restriction-type-id}` (GET) zur Verwaltung von Restriction-Type-Definitionen.
  * Endpoint `/public/v1/reporting-service/file-reports/scored-attribution` (GET) für Scored-Attribution-Dateiberichte.
  * Endpoint `/public/v1/reporting-service/file-reports/interactions` (GET) zum Export von Interaktionsdaten.
  * DELETE-Methode zu `/public/v1/toppie/campaigns/{campaign-id}` hinzugefügt, um Kampagnen zu löschen.

  ### Geändert

  * Events: Fehlende Referenzen für das neue Pageview-Objekt hinzugefügt.
  * `/v2/events`: Optionale Felder `deviceType` und `channel` für Impressions, Clicks, Purchases und Pageviews hinzugefügt.
</Update>

<Update label="März 2025" description="2025-03-03 bis 2025-03-26">
  ### Hinzugefügt

  * Beta-Endpoint `/toptimize/v1/rank` zum Ranking von Objekten.
  * Endpoints `/public/v1/segment-service/segments` (GET, PUT) und `/public/v1/segment-service/segments/{segment-id}` (DELETE) zur Segment-Verwaltung.
  * Endpoint `/public/v1/segment-service/segments/{segment-id}/signed-url` (GET) zum Abrufen signierter URLs für Segment-Uploads.
  * Endpoint `/public/v1/toppie/products` (GET) zum Auflisten von Vendor-Produkten in Toppie.
  * Endpoint `/public/v1/reporting-service/interactions` (GET) zur Abfrage von Interaktionsdaten.
  * Endpoint `/public/v1/toppie/account/balance` (GET) zum Anzeigen des Kontostands.
  * Endpoint `/public/v1/toppie/account/topups` (GET) zum Anzeigen von Kontoaufladungen.
  * Endpoint `/public/v1/billing-service/campaign-billing-contact` (GET, PUT).
  * Endpoints `/public/v1/billing-service/billing-contacts` (GET) und `/public/v1/billing-service/billing-contacts/{billing-contact-id}` (GET, PUT) zur Verwaltung von Billing-Kontakten auf Marketplace-Ebene.
  * Endpoints `/public/v1/billing-service/vendor-billing-contact` (PUT) und `/public/v1/billing-service/vendors/{external-vendor-id}/vendor-billing-contact/{billing-contact-id}` (DELETE) für Billing-Kontakte auf Vendor-Ebene.
  * PATCH-Methode zu `/public/v1/toppie/campaigns/{campaign-id}` hinzugefügt, um Kampagnen zu aktualisieren.

  ### Geändert

  * `/v2/auctions/sponsored-brand`: Optionale Felder `opaqueUserId` und `vendorId` hinzugefügt.
  * Events: Beispiel für Placement-Tracking für Carousel-Analyse hinzugefügt.
  * `/v2/auctions/travel`: Erweitert, um neben Hotels auch **Flüge** zu unterstützen.
</Update>

<Update label="Februar 2025" description="2025-02-04 bis 2025-02-26">
  ### Hinzugefügt

  * Endpoints `/public/v1/toppie/campaigns` (GET, POST) und `/public/v1/toppie/campaigns/{campaign-id}` (GET) zur Verwaltung von Toppie-Kampagnen.
  * Endpoint `/public/v1/toppie/campaigns/{campaign-id}/bids` (GET) zur Verwaltung von Kampagnengeboten.
  * Toppie-Reporting-Endpoints (`/public/v1/toppie/reporting`)
  * Endpoints `/public/v1/billing-service/vendors/{external-vendor-id}/wallets` (GET, POST) und `/public/v1/billing-service/vendors/{external-vendor-id}/wallets/{wallet-id}/adjust` (POST) zur Verwaltung von Vendor-Wallets.
  * PATCH-Methode zu `/public/v1/catalog-search-service/catalogs/products` hinzugefügt, um Produkte zu aktualisieren.

  ### Geändert

  * Events: Dokumentiert, dass Halo-Attribution `vendorId` erfordert.
</Update>

<Update label="Januar 2025" description="2025-01-06 bis 2025-01-28">
  ### Hinzugefügt

  * Endpoint `/v2/auctions/travel` für Hotel-Reise-Auktionen.
  * Beta-Endpoint `/v2/events/beta/link-users` zum Verknüpfen von Benutzerkonten.
  * Endpoints `/public/v1/reporting-service/marketplace/campaigns-kpis` (GET) und `/public/v1/reporting-service/marketplace/vendors-kpis` (GET) für KPI-Berichte auf Marketplace-Ebene.
</Update>