Before you begin
The Criteo Retail Media API uses the same authentication, versioning, and error model as all Criteo APIs. Read these pages before writing your first request:- Create your API application — register an app and obtain a client ID
- Get your credentials — generate the client secret you’ll use to authenticate
- OAuth client credentials setup — exchange your credentials for an access token
- Rate limits — understand request quotas and how to handle 429 responses
- API error codes — reference for all error responses
Who is this API for?
- Brands — You have preferred tools and the development resources to build with our APIs
- Agencies — You offer complementary tools to brands who prefer your managed services
- Partners — You offer complementary tools to brands or agencies to enrich their retail media campaigns
- Retailers — Reach out to your Criteo representative to discuss your needs
- Marketplaces — You operate a platform with users who are sellers
Criteo API Version Tiers Overview
Criteo API versions follow a three-stage lifecycle. Choose the tier that fits your needs — or keep reading to learn what this version offers.Stable
You are here. Fully supported for 12 months with no breaking changes. The right choice for all production integrations.
Release Candidate
Production-ready preview of the next stable version. Integrate early and you’re already on the right version the moment it goes stable.
Experimental
Early access to brand-new features before they’re finalized. Contracts may change — not for production use.
For the full version lifecycle — deprecation windows, release schedule, fall-forward — see the Versioning policy.