Skip to main content
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:
URL
to the new base URL:
URL

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.