GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In
Guides

What's New in 2024-01

This page lists all endpoint changes related to the v2024.01 release

📅

Version Schedule

Version 2024.01 of the Criteo retail media API is live as of January 23rd, 2024. This version will be supported until July 31st, 2024.

Following this new version release, version 2023.01 will lose support starting January 30th, 2024

This version introduces new capabilities to Criteo Retail Media API and changes to existing endpoints. This page aims at listing all changes that happened endpoint per endpoint. Only endpoints with changes are listed here.

New Base URL

With the introduction of this new version, the base URL will now change from the

Old base URL

https://api.criteo.com/2023-10/retail-media/{endpoint}

to

New base URL

https://api.criteo.com/2024-01/retail-media/{endpoint}

What's New

In version 2024.01, we've introduced two new sets of endpoints. One that allows you to retrieve and edit campaign budget overrides. The other allows you to create and download a revenue report to understand where your retail media revenue is coming from, providing visibility across all advertisers, media, and direct/indirect sales channels. Note, the revenue report is only available for supply account owners (retailers).

Updated Endpoints Includes

Budget Overrides

VerbEndpointDescription
GETcampaigns/{campaignId}/campaign-budget-overridesRetrieves all existing budget overrides at the campaign level.
PUTcampaigns/{campaignId}/campaign-budget-overridesReplaces all existing campaign budget override settings. Use this endpoint to add/remove or update existing budget overrides.
GETline-items/{lineItemId}/line-item-budget-overridesRetrieves all existing budget overrides at the line-item level.

SSP Revenue Report

VerbEndpointDescription
POST/retail-media/reports/revenueGenerate a retailer revenue report
GET/reports/{reportId}/outputDownload Output of a Specific Report
GET/reports/{reportId}/statusGet Status of a Specific Report