Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

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.

Amazon MWS Documentation

Processing bulk operation requests

Describes how to process operations in bulk by using the ASINList, SellerSKUList, and IdList request parameters.

Operations in the Amazon MWS Products API section that take an ASINList, SellerSKUList, or IdList as input parameters can return the results from each of these inputs separately from all the other inputs. This means that if you specify 20 ASINs with the ASINList input parameter of the GetCompetitivePricingForASIN operation, for example, and the operation can only get data for 18 of these ASINs, the operation will return results for the 18 ASINs instead of failing the entire request. The operation will also indicate that the remaining two ASINs failed. The seven bulk operations that take either an ASINList, SellerSKUList, or IdList as input parameters are: GetMatchingProduct, GetMatchingProductForId, GetCompetitivePricingForSKU, GetCompetitivePricingForASIN, GetLowestOfferListingsForSKU, GetLowestOfferListingsForASIN, and GetMyFeesEstimate.

The following example shows how to use the ASINList input parameter to specify three ASINs in a query request:

https://mws.amazonservices.com/Products/2011-10-01
?AWSAccessKeyId=AKIAJGUVGFGHNKE2NVUA
&Action=GetMatchingProduct
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&SellerId=A2NK2PX936TF53
&SignatureVersion=2
&Timestamp=2012-02-07T01%3A22%3A39Z
&Version=2011-10-01
&Signature=MhSREjubAxTGSldGGWROxk4qvi3sawX1inVGF%2FepJOI%3D
&SignatureMethod=HmacSHA256
&MarketplaceId=ATVPDKIKX0DER
&ASINList.ASIN.1=B002KT3XRQ
&ASINList.ASIN.2=B002KT3XQC
&ASINList.ASIN.3=B002KT3XQM

A query request using the SellerSKU input parameter would be formed similarly, replacing &ASINList.ASIN with &SellerSKUList.SellerSKU and ASIN values with SellerSKU values. Likewise, a query request using the Id input parameter would be formed similarly, replacing &ASINList.ASIN with &IdList.Id and ASIN values with Id values.

Bulk operations in the Amazon MWS Products API section return an OperationNameResult response element for each product identifier (ASIN, SellerSKU, or Id) that is specified in the request. Each OperationNameResult response element contains a Status attribute that indicates whether or not data could be returned for the specified product identifier, and an ASIN, SellerSKU, or Id attribute that indicates the ASIN, SellerSKU, or Id value that was specified in the request.

The following table shows response elements that are returned by bulk operations in the Amazon MWS Products API section. Note that you can find examples of these response elements in the appropriate Example response sections throughout this document.

Response elements in bulk operations

Name Description
OperationNameResult An element that is returned for each product identifier (ASIN, SellerSKU, or Id) that is specified in the request. For example, if you submit the GetLowestOfferListingsForSKU operation, this element will be named GetLowestOfferListingsForSKUResult.
Status An attribute of the OperationNameResult element. Indicates whether or not data could be returned for the specified product identifier (ASIN, SellerSKU, or Id).

Valid values:

  • Success - Request succeeded.
  • ClientError - Request failed. The problem was with the request.
  • ServerError - Request failed. The problem was with the web service.
ASIN

An attribute of the OperationNameResult element. Indicates the ASIN that was specified in the request.

Required for operations that take an ASIN as input.

SellerSKU

An attribute of the OperationNameResult element. Indicates the SellerSKU that was specified in the request.

Required for operations that take an SellerSKU as input.

IdType

An attribute of the OperationNameResult element. Indicates the IdType that was specified in the request.

Required for operations that take an IdType as input.

Id

An attribute of the OperationNameResult element. Indicates the Id that was specified in the request.

Required for operations that take an Id as input.

Error

The parent element of the following child elements: Type, Code, Message.

This element is returned only if status=ClientError OR status=ServerError.

Optional.

Code

The type of error that resulted in a failed response.

Example: InternalError

Optional.

Type

Indicates whether the error was a result of a problem in the request or with the web service.

Valid values:
  • Sender - The problem was in the request.
  • Receiver - The problem was with the web service.

Optional.

Message

Contains a message that provides more information about the error.

Example: SellerSKU1 is an invalid SellerSKU for marketplace ATVPDKIKX0DER.

Optional.

Detail

Contains any additional details, if applicable.

Optional.

Example response

<?xml version="1.0"?>
<OperationNameResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<OperationNameResult ASIN=”B002KT3XQM” status=”Success”>
  <!—Successful response goes here-->
</OperationNameResult>
<OperationNameResult ASIN=”B000O15GSG” status=”ClientError”>
  <Error>
    <Code>InvalidParameterValue</Code>
    <Type>Sender</Type>
    <Message>B000O15GSG is an invalid ASIN for marketplace ATVPDKIKX0DER</Message>
    <Detail/>
  </Error>
</OperationNameResult>
<ResponseMetadata>
  <RequestId>454d8b3c-5514-4919-b5ca-6a08fb974272</RequestId>
</ResponseMetadata>
</OperationNameResponse>