Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
Describes the throttling policy for the Products API section.
The Products API section uses two types of throttling. All the operations in the Products API section use the standard per-request throttling described in Throttling: Limits to how often you can submit requests. All of the operations have a Maximum request quota and Hourly request quota measured by request. Many of the operations also throttle based on the number of items returned by an operation. These operations use a Restore rate based on the items instead of requests.
These are the throttling rates for the Products API section operations that only throttle per request.
Operation | Maximum request quota | Restore rate | Hourly request quota |
---|---|---|---|
ListMatchingProducts | 20 requests | One request every five seconds | 720 requests per hour |
GetProductCategoriesForSKU and GetProductCategoriesForASIN | 20 requests | One request every five seconds | 720 requests per hour |
Operations in the Products API section that send lists of items as input parameters have restore rates that are measured by item. These operations also have request limits, but callers are likely to hit item limits first. Requests are calculated for each Amazon seller account and Amazon MWS developer account pair.
Restore rates measured by item improve throughput for sellers who look up many items one at a time. In this scenario (scanning single items with a scanner, for example) the seller includes a single item with each request. Suppose, for example, that a seller is submitting the GetLowestOfferListingsForSKU operation many times in succession. After depleting their request quota, they only need to wait one second to submit ten more GetLowestOfferListingsForSKU requests in succession (provided that each request contains only one item).
When restore rates are by item, and you batch multiple items in a request, it is possible to exceed your item quota without exceeding your request quota. In this case you will have to wait for the item restore rate to restore enough items to satisfy your next request.
These are the throttling rates for the Products API section operations that throttle per item.
Operation | Maximum request quota | Restore rate | Hourly request quota |
---|---|---|---|
GetMatchingProduct | 20 requests | Two items every second | 7200 requests per hour |
GetMatchingProductForId | 20 requests | Five items every second | 18000 requests per hour |
GetCompetitivePricingForSKU and GetCompetitivePricingForASIN | 20 requests | 10 items every second | 36000 requests per hour |
GetLowestOfferListingsForSKU and GetLowestOfferListingsForASIN | 20 requests | 10 items every second | 36000 requests per hour |
GetLowestPricedOffersForSKU and GetLowestPricedOffersForASIN | 10 requests | Five items every second | 200 requests per hour |
GetMyFeesEstimate | 20 requests | 10 items every second | 36000 requests per hour |
GetMyPriceForSKU and GetMyPriceForASIN | 20 requests | 10 items every second | 36000 requests per hour |
Note: