Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation
Amazon MWS Documentation

Throttling in the Products API

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.

Per-Request Throttling

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

Per-Item Throttling

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:

  • The GetCompetitivePricingForSKU and GetCompetitivePricingForASIN operations together share the same maximum request quota and the same restore rate.
  • The GetLowestOfferListingsForSKU and GetLowestOfferListingsForASIN operations together share the same maximum request quota and the same restore rate.
  • The GetLowestPricedOffersForSKU and GetLowestPricedOffersForASIN operations together share the same maximum request quota and the same restore rate.
  • The GetMyPriceForSKU and GetMyPriceForASIN operations together share the same maximum request quota and the same restore rate.
  • The GetProductCategoriesForSKU and GetProductCategoriesForASIN operations together share the same maximum request quota and the same restore rate.