Version 2026.01 Release Note
Version
2026.01of Criteo's API is live as of January 27th, 2026 and will be supported until February 2nd, 2027.
- A new Postman collection for
2026.01is also available in the Criteo Postman workspace.- New SDK versions are available for the
2026.01release. You can find them on this page.
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:
| Verb | Endpoint | Description |
|---|---|---|
| POST | /commerce-grid/audience-segments/create | Create a new Audience Segment |
| PATCH | /commerce-grid/audience-segments | Update an Audience Segment |
| POST | /commerce-grid/audience-segments/delete | Delete an Audience Segment |
| POST | /commerce-grid/audience-segments/search | Search for Audience Segments by segment IDs, data provider IDs and/or segment types |
| GET | /commerce-grid/audience-segments/{audienceSegmentId}/contact-list/statistics | Retrieve contact list statistics |
| POST | /commerce-grid/audience-segments/{audienceSegmentId}/contact-list/add-remove | Add/remove identifiers in contact list Audience Segment |
| POST | /commerce-grid/audience-segments/{audienceSegmentId}/contact-list/clear | Clear all identifiers in contact list Audience Segment |
See the full documentation on this page and the corresponding API reference section here.