Version 2023.04 Release Notes
Version 2023.04 of the Criteo retail media API is live as of April 18th, 2023 and will be supported until April 30th, 2024. A new Postman collection for 2023.04 is also available in the Criteo Postman workspace.
New SDK Release
We are working on new improvements to our SDK library for retail media and marketing solutions. A new SDK version will not be available for the 2023.04 release.
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-01/retail-media/{endpoint}
to
New base URL
https://api.criteo.com/2023-04/retail-media/{endpoint}
What's New
Keyword Endpoints
In version 2023.04, we introduce new keyword endpoints. The new keywords API lets you control your open auction line item by determining which keyword to target positively or negatively. The new set of endpoints also provides keyword bidding capabilities to optimize line items based on relevant keywords.
New Endpoints Includes**
Keyword Targeting
Verb | Endpoint | Description |
---|---|---|
GET | /line-items/{LineItemId}/keywords | Retrieve a set of positive and negative keywords for a line item |
POST | /line-items/{LineItemId}/keywords/add-remove | Add or remove keywords from a line item |
v1 - Negative Keyword Endpoint Deprecation
The Keywords API will be replacing the existing Negative Keyword Targeting endpoints. Applications using these endpoints are encouraged to migrate to the new keyword endpoints as we plan to deprecate the old endpoints in future stable API versions.
Keyword Bidding
Endpoint | Verb | Description |
---|---|---|
/line-items/{LineItemId}/keywords/set-bid | POST | Add or remove keywords from a line item. |