Version 2023.04 Release Notes - Criteo Docs

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.