Skip to main content
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 ReleaseWe 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 DeprecationThe 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.