Version 2026.01 Release Note

📘

Version 2026.01 of Criteo's API is live as of January 27th, 2026 and will be supported until February 2nd, 2027.


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

The changes in versions 2026.01 are:

  • a new base URL,
  • New Commerce Grid Audience Segment endpoints have been introduced.

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/2025-10/{endpoint}

to the new base URL:

https://api.criteo.com/2026-01/{endpoint}

What's New

New Commerce Grid Audience Segments Endpoints

Criteo's Commerce Grid Audience Segments API allows you to manage your audience segments by creating, deleting, and updating their data. Audience Segments represent a group of users to target.

The new available endpoints are the following:

VerbEndpointDescription
POST/commerce-grid/audience-segments/createCreate a new Audience Segment
PATCH/commerce-grid/audience-segmentsUpdate an Audience Segment
POST/commerce-grid/audience-segments/deleteDelete an Audience Segment
POST/commerce-grid/audience-segments/searchSearch for Audience Segments by segment IDs, data provider IDs and/or segment types
GET/commerce-grid/audience-segments/{audienceSegmentId}/contact-list/statisticsRetrieve contact list statistics
POST/commerce-grid/audience-segments/{audienceSegmentId}/contact-list/add-removeAdd/remove identifiers in contact list Audience Segment
POST/commerce-grid/audience-segments/{audienceSegmentId}/contact-list/clearClear all identifiers in contact list Audience Segment
📘

See the full documentation on this page and the corresponding API reference section here.