Throttling

The API throttling level has been set for each Partner per API. If you try to exceed the limits, your API calls will be returned with an error 429, “Too Many Requests.”

The following table represents the default throttling limits. If you exceed the levels listed below, review your algorithms and optimize for fewer calls. If you still encounter errors, contact Partner Support.

ASYNC API throttling limits

SYNC API throttling limits

API call allotment replenishment

The hourly and daily ASYNC and SYNC API calls are throttled. However, the limits are replenished gradually. The allotment increases every few minutes for hourly limits, so the full hourly limits are available after the hour. Daily limits are similarly replenished every few hours.

For example, if 20 calls are available every hour, one call will be available every 3 minutes after all the calls are already consumed. It is recommended that header values be used to access higher API call allotments.

Scenarios where to use feed APIs / bulk update APIs vs non-feed APIs

The APIs above are feed/bulk update APIs that are used to perform updates and tasks on a day-to-day basis, such as (Bulk Item Inventory Update, Bulk Item Setup (Multiple), etc.). For these APIs, sellers have to submit the feed files as part of the feed API call and check the progress using feed status API (Marketplace Seller Feed item status API link).

Other non-feed APIs (such as Update inventory API and Update Item Inventory per Ship Node API ) should be used only in exception scenarios. They are primarily designed for emergency use and are highly throttled.

API throttling response headers

For throttled APIs, use these response headers to get the current throttling usage: