Rate Limits

Criteo Retail Media API enforces a rate limit which consists of a limitation in the number of calls you're able to perform on any of its endpoints. This limitation is enforced to provide all our API partners with the utmost stability towards our API infrastructure.

Rate limits are implemented at the App level and allow for a maximum of 250 calls per minute.

📘

Note that some resource-sensitive endpoints may have specific rate limits applied to them

Response

If your App exceeds the given rate limit, you will receive a 429 HTTP response and be blocked from executing the action. The following information will be provided in the header:

• x-ratelimit-limit = number of calls your App can perform

• x-ratelimit-remaining = number of calls remaining, resets every minute

• x-ratelimit-reset = timestamp

 

📘

How to avoid rate limits?

For the best experience, while using Criteo Retail Media API, we strongly encourage our API partners to use throttling mechanisms which allow spreading the number of calls in a larger timeframe. We also encourage using our bulk capabilities when available (i.e. when calling our reporting endpoints).

Learn more about Bulk calls here.