GuidesAPI ReferenceChangelogDiscussions
GuidesAPI ReferenceChangelogLog In

Rate Limits

This page describes Rate limit policy on Criteo Retail Media API.

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.

Response

By going beyond your App limit of calls, you will be getting a 429 HTTP Response, and as such, won't be able to perform the actions you expected to. We will be providing you with the following information in the header:

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

  • x-ratelimit-remaining = nb. of calls remaining, gets reset every minute

  • x-ratelimit-reset = timestamp

858858

Example response with a limit set at 20 calls/seconds

📘

How to avoid rate limits?

For 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 do also encourage using our bulk capabilities when available (i.e. when calling our reporting endpoints).

We also encourage our partners to use our bulk capabilities when possible, example when requesting reporting for several campaigns or line items.

Learn more about Bulk calls here.