API rate limiting
What is rate limiting?
Rate limiting is the practice of setting caps on the number of requests an API can handle within any specific time frame. The Analytics API depends on a central inventory management system that has finite capacity. Limiting the traffic allowed at one time protects the system from over-utilization, which benefits both Expedia and our partners.
Traffic optimization is achieved by limiting the volume of traffic a partner can request to reasonable levels. These rate limits ensure the continued delivery of a stable and maintainable service to partners while also guaranteeing the efficient use of Expedia Group systems.
Headers
We include a number of headers on most of our responses in order to help you see what load your calls are creating. We include the full set of headers on as many responses as we can, but we cannot guarantee they will be provided for every response, so please plan accordingly.
| Parameter (header) | Description | Value |
|---|---|---|
Rate-Limit-Day-Remaining | Optional header for the remaining capacity, as a percentage, for the daily time window. | Number |
Rate-Limit-Day-Reset | Optional header for the timestamp, as the number of milliseconds since the Unix Epoch, when the daily capacity resets. | Number |
Rate-Limit-Minute-Remaining | Optional header for the remaining capacity, as a percentage, for the per minute time window. | Number |
Rate-Limit-Minute-Reset | Optional header for the timestamp, as the number of milliseconds since the Unix Epoch, when the per minute capacity resets. | Number |
Rate-Limit-Reduction-Status | Optional header that indications the state (inactive, active) of minute capacity reduction triggered once all daily capacity has been used. | String |