Version 2025.10 Release Notes

📘

Version 2025.10 of Criteo's API is live as of October 21st, 2025 and will be supported until October 27th, 2026. A new Postman collection for 2025.10 is also available in the Criteo Postman workspace.

📘

New SDK Release

A new SDK version will be available for the 2025.10 release.


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 2025.10 are:

  • a new base URL,
  • updates to Authorization Code application rate limiting,
  • Product Sets endpoint has moved from preview to the stable version

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

to the new base URL:

https://api.criteo.com/2025-10/{endpoint}

What's New


Authorization Code Rate Limiting

We’ve introduced auto-scaling rate limits for Authorization Code applications (this does not apply to Client Credentials apps):

  • Baseline: 10 calls per minute per account.
  • The limit scales with the number of accounts a single consent granter has granted to the app.

Examples

  • If Bob granted consent to accounts 1, 2, and 3 → Bob’s app limit = 3 * 10 = 30 calls per minute (shared across those three accounts). Bob could use all 30 calls per minute on one account, but that reduces what’s available for the others in that minute.
  • If Alice consented to account 4 and Jen consented to account 5 → the app can call “as Alice” at 10 calls per minute and “as Jen” at 10 calls per minute (limits are per consent granter).

Guidance: Application owners should align consent granters strategically to scale limits according to expected operations.

📘

See the updated Authorization Code rate-limit documentation here.




Product Sets Moves to Stable

The Product Sets endpoint has moved from Preview to Stable.

A Product Set is a subset of your product catalog that can be featured in dynamic ads.

  • Create Product Sets using rule-based conditions on catalog attributes (conditions are additive, like an AND operator).
  • Apply a Product Set to an Ad as a filter. After you do, Ads will display only products from that Product Set.
📘

See the stable endpoint documentation here.