Version 2021.10 release notes
What’s new?
Version 2021.10 of the Criteo API is live as of January 5th, 2022. This version will be supported until January 4th, 2023.
This version introduces several new capabilities to Criteo Retail Media API and introduces changes in previously existing endpoints.
This page aims at listing all changes that happened endpoint per endpoint. Only endpoints with changes are listed here.
New Base url
We are moving from:
https://api.criteo.com/2021-07/retail-media/{endpoint}
tohttps://api.criteo.com/2021-10/retail-media/{endpoint}
Addition / removal of items
Using PUT and DELETE methods to add or remove items is deprecated. Instead, dedicated /append and /delete endpoints have been added, that can be called using POST method
Reporting
It is now possible to request a report for multiple campaigns or line items at once. To do so, the id parameter much be replaced by ids and its value be an array of the campaign or line items to report on.
Modified endpoints are
/2021-10/retail-media/reports/campaigns/2021-10/retail-media/reports/line-items
Catalog filtering
It is now possible to restrict catalog request to particular brand(s), by indicating them in the brandIdFilter .
Affected endpoints is /2021-10/retail-media/accounts/{accountId}/catalogs
No other change was made to the request nor response.
Access to Preferred Deals capabilities
Our Preferred Deals capabilities are currently only accessible to our Retailer partners as part of our beta launch.
To gain access to Preferred Deals documentation, please reach out to your Criteo Account Manager.