Amazon Market Service Product API Reference manual

Amazon Marketplace Web Service ProductsAPI Section Reference (Version 2011-10-01)

2 Amazon Marketplace Web Service Products API Section Reference (Version 2011-10-01) 2

Amazon Marketplace Web Service Products API Section Reference (Version 2011-10-01) 2

Contents

Amazon Marketplace Web Service Products API Section Reference (Version 2011-10-01)................... 4

What you should know about the Amazon MWS Products API section.................................................. 5Processing bulk operation requests............................................................................................................................................................5Throttling......................................................................................................................................................................................................7

ListMatchingProducts.................................................................................................................................... 9Description...................................................................................................................................................................................................9Request parameters....................................................................................................................................................................................9Response elements.....................................................................................................................................................................................9Examples................................................................................................................................................................................................... 10Related topics............................................................................................................................................................................................12

GetMatchingProduct.................................................................................................................................... 13Description.................................................................................................................................................................................................13Request parameters..................................................................................................................................................................................13Response elements...................................................................................................................................................................................13Examples................................................................................................................................................................................................... 13Related topics............................................................................................................................................................................................16

GetMatchingProductForId........................................................................................................................... 17Description.................................................................................................................................................................................................17Request parameters..................................................................................................................................................................................17Response elements...................................................................................................................................................................................17Examples................................................................................................................................................................................................... 17Related topics............................................................................................................................................................................................21

GetCompetitivePricingForSKU....................................................................................................................22Description.................................................................................................................................................................................................22Request parameters..................................................................................................................................................................................22Response elements...................................................................................................................................................................................22Examples................................................................................................................................................................................................... 23Related topics............................................................................................................................................................................................25

GetCompetitivePricingForASIN...................................................................................................................26Description.................................................................................................................................................................................................26Request parameters..................................................................................................................................................................................26Response elements...................................................................................................................................................................................26Examples................................................................................................................................................................................................... 26Related topics............................................................................................................................................................................................27

GetLowestOfferListingsForSKU..................................................................................................................28Description.................................................................................................................................................................................................28Request parameters..................................................................................................................................................................................28Response elements...................................................................................................................................................................................29Examples................................................................................................................................................................................................... 30Related topics............................................................................................................................................................................................32

GetLowestOfferListingsForASIN.................................................................................................................33Description.................................................................................................................................................................................................33Request parameters..................................................................................................................................................................................33Response elements...................................................................................................................................................................................33



Examples................................................................................................................................................................................................... 33Related topics............................................................................................................................................................................................35

GetMyPriceForSKU.......................................................................................................................................36Description.................................................................................................................................................................................................36Request parameters..................................................................................................................................................................................36Response elements...................................................................................................................................................................................36Examples................................................................................................................................................................................................... 37Related topics............................................................................................................................................................................................38

GetMyPriceForASIN......................................................................................................................................39Description.................................................................................................................................................................................................39Request parameters..................................................................................................................................................................................39Response elements...................................................................................................................................................................................39Examples................................................................................................................................................................................................... 39Related topics............................................................................................................................................................................................40

GetProductCategoriesForSKU.................................................................................................................... 41Description.................................................................................................................................................................................................41Request parameters..................................................................................................................................................................................41Response elements...................................................................................................................................................................................41Examples................................................................................................................................................................................................... 41Related topics............................................................................................................................................................................................42

GetProductCategoriesForASIN................................................................................................................... 43Description.................................................................................................................................................................................................43Request parameters..................................................................................................................................................................................43Response elements...................................................................................................................................................................................43Examples................................................................................................................................................................................................... 43Related topics............................................................................................................................................................................................44

GetServiceStatus.......................................................................................................................................... 45Description.................................................................................................................................................................................................45Request parameters..................................................................................................................................................................................45Response elements...................................................................................................................................................................................45Examples................................................................................................................................................................................................... 45Related topics............................................................................................................................................................................................46

QueryContextId Values................................................................................................................................47

Client library updates.................................................................................................................................. 52



Amazon Marketplace Web Service ProductsAPI Section Reference (Version 2011-10-01)

Copyright © 2011-2013 Amazon.com, Inc. or its affiliates.

AMAZON and AMAZON.COM are registered trademarks of Amazon.com, Inc. or its affiliates. All other trademarksare the property of their respective owners.

Last updated: 2013-11-18



What you should know about the AmazonMWS Products API section

The Products API section of Amazon Marketplace Web Service (Amazon MWS) helps you get information to matchyour products to existing product listings on Amazon Marketplace websites and to make sourcing and pricing decisionsfor listing those products on Amazon Marketplace websites. The Amazon MWS Products API returns productattributes, current Marketplace pricing information, and a variety of other product and listing information.

Note: The Amazon MWS Products API section is only for products listed on Amazon marketplace websites.The Amazon MWS Products API section is not for Checkout by Amazon or Amazon WebStore.

The Products API section contains the following operations:

Operation Description

ListMatchingProducts Returns a list of products and their attributes, based on a search query.

GetMatchingProduct Returns a list of products and their attributes, based on a list of ASINvalues.

GetMatchingProductForId Returns a list of products and their attributes, based on a list of ASIN,GCID, SellerSKU, UPC, EAN, ISBN, and JAN values.

GetCompetitivePricingForSKU Returns the current competitive price of a product, based on SellerSKU.

GetCompetitivePricingForASIN Returns the current competitive price of a product, based on ASIN.

GetLowestOfferListingsForSKU Returns pricing information for the lowest-price active offer listings fora product, based on SellerSKU.

GetLowestOfferListingsForASIN Returns pricing information for the lowest-price active offer listings fora product, based on ASIN.

GetMyPriceForSKU Returns pricing information for your own offer listings, based onSellerSKU.

GetMyPriceForASIN Returns pricing information for your own offer listings, based on ASIN.

GetProductCategoriesForSKU Returns the parent product categories that a product belongs to, basedon SellerSKU.

GetProductCategoriesForASIN Returns the parent product categories that a product belongs to, basedon ASIN.

GetServiceStatus Returns the operational status of the Products API section.

Processing bulk operation requestsDescribes 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 asinput parameters can return the results from each of these inputs separately from all the other inputs. This meansthat if you specify 20 ASINs with the ASINList input parameter of the GetCompetitivePricingForASINoperation, for example, and the operation can only get data for 18 of these ASINs, the operation will returnresults for the 18 ASINs instead of failing the entire request. The operation will also indicate that the remainingtwo ASINs failed. The six bulk operations that take either an ASINList, SellerSKUList, or IdList as inputparameters are: GetMatchingProduct, GetMatchingProductForId, GetCompetitivePricingForSKU,GetCompetitivePricingForASIN, GetLowestOfferListingsForSKU, and GetLowestOfferListingsForASIN.

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&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 inputparameter 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 elementfor each product identifier (ASIN, SellerSKU, or Id) that is specified in the request. Each OperationNameResultresponse element contains a Status attribute that indicates whether or not data could be returned for the specifiedproduct identifier, and an ASIN, SellerSKU, or Id attribute that indicates the ASIN, SellerSKU, or Id value that wasspecified in the request.

The following table shows response elements that are returned by bulk operations in the Amazon MWS Products APIsection. Note that you can find examples of these response elements in the appropriate Example response sectionsthroughout 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 yousubmit the GetLowestOfferListingsForSKU operation, this elementwill be named GetLowestOfferListingsForSKUResult.

Status An attribute of the OperationNameResult element. Indicates whetheror 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 webservice.

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

Required for operations that take an ASIN as input.

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

Required for operations that take an SellerSKU as input.

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

Required for operations that take an IdType as input.

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



Name Description

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 ORstatus=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 orwith 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 marketplaceATVPDKIKX0DER.

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>

ThrottlingDescribes the throttling policy for the Products API section.



The Products API section uses a different type of throttling than the other API sections of Amazon MWS.Operations in the Products API section that send lists of items as input parameters (GetMatchingProduct,GetMatchingProductForId, GetCompetitivePricingForSKU, GetCompetitivePricingForASIN,GetLowestOfferListingsForSKU, GetLowestOfferListingsForASIN, GetMyPriceForSKU, andGetMyPriceForASIN) have restore rates that are measured by item. This is in contrast to the way restore rates work forthe other operations in Amazon MWS, which are measured by request. Requests are calculated for each Amazon selleraccount 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, forexample, that a seller is submitting the GetLowestOfferListingsForSKU operation many times in succession. Afterdepleting his request quota, he need only wait one second to submit ten more GetLowestOfferListingsForSKUrequests in succession (provided that each request contains only one item).

For more information about throttling, see the throttling section of the Amazon MWS Developer Guide.

The following table lists the throttling rates for the Products API section.

Operation Maximum request quota Restore rate

ListMatchingProducts 20 requests One request every five seconds

GetMatchingProduct 20 requests Two items every second

GetMatchingProductForId 20 requests Five items every second

GetCompetitivePricingForSKU andGetCompetitivePricingForASIN

20 requests 10 items every second

GetLowestOfferListingsForSKU andGetLowestOfferListingsForASIN

20 requests 10 items every second

GetMyPriceForSKU and GetMyPriceForASIN 20 requests 10 items every second

GetProductCategoriesForSKU andGetProductCategoriesForASIN

20 requests One request every five seconds

Note:

• The GetCompetitivePricingForSKU and GetCompetitivePricingForASIN operations together share the samemaximum request quota and the same restore rate.

• The GetLowestOfferListingsForSKU and GetLowestOfferListingsForASIN operations together share thesame maximum request quota and the same restore rate.

• The GetMyPriceForSKU and GetMyPriceForASIN operations together share the same maximum request quota andthe same restore rate.

• The GetProductCategoriesForSKU and GetProductCategoriesForASIN operations together share the samemaximum request quota and the same restore rate.



ListMatchingProductsReturns a list of products and their attributes, based on a search query.

DescriptionThe ListMatchingProducts operation returns a list of products and their attributes, ordered by relevancy, based ona search query that you specify. Your search query can be a phrase that describes the product or it can be a productidentifier such as a GCID, UPC, EAN, ISBN, or JAN. If you have the ASIN associated with your product, use theGetMatchingProduct operation. Note that the product identifier cannot be a SellerSKU. If your query does not returnany matching products, the query will be broadened using spelling correction or the removal of keywords to findmatches. This operation returns a maximum of ten products and does not return non-buyable products.

Request parametersFor more information about the request parameters that are required for all Amazon MWS operations, see "Requiredrequest parameters" in the Amazon MWS Developer Guide.

Name Description Required

MarketplaceId A marketplace identifier. Specifies the marketplace from which productsare returned.

Type: xs:string

Yes

Query A search string with the same support as that provided on Amazonmarketplace websites.

Example: Query=harry potter dvd

Type: xs:string

Yes

QueryContextId An identifier for the context within which the given search will beperformed. A marketplace might provide mechanisms for constraininga search to a subset of potential items. For example, the Amazon retailmarketplace allows queries to be constrained to a specific category. TheQueryContextId parameter specifies such a sub-set. If it is omitted, thesearch will be performed using the default context for the marketplace,which will typically contain the largest set of items. See QueryContextIdValues for a complete list of QueryContextId values that can be used inthe various Amazon retail marketplaces.

Type: xs:string

No

Response elementsThe response elements that the ListMatchingProducts operation returns are described by the following publiclyavailable XSDs:

• Product.xsd: http://g-ecx.images-amazon.com/images/G/01/mwsportal/doc/en_US/products/Product.xsd• default.xsd: http://g-ecx.images-amazon.com/images/G/01/mwsportal/doc/en_US/products/default.xsd

The following table provides additional information about some of the key elements that are returned by theListMatchingProducts operation.

Note: As Amazon updates the Amazon MWS Products API section to include new response elements, wemay update the Product.xsd and default.xsd schemas. Keep this in mind if you choose to use these schemas forvalidation.

http://g-ecx.images-amazon.com/images/G/01/mwsportal/doc/en_US/products/Product.xsd

http://g-ecx.images-amazon.com/images/G/01/mwsportal/doc/en_US/products/default.xsd



Name Description

Product Contains four of the sub-elements of the Product element fromProduct.xsd. These sub-elements are: Identifiers, AttributeSets,Relationships, and SalesRankings.

Identifiers Contains the MarketplaceASIN combination that uniquely identifies aproduct.

AttributeSets Contains product attributes, from the ItemAttributes element ofdefault.xsd, if they are applicable to the product that is returned. Notethat a Product response element will have multiple attribute sets if ithas attributes in more than one language. All of the attributes, even onesthat are not translated, are repeated in each attribute set. The languageused by each attribute set is denoted by a lang attribute.

Relationships Contains product variation information, if applicable. If your searchcriteria match a product that is identified by a variation parent ASIN,the related VariationChild elements are contained in the Relationshipselement. If your search criteria match a specific variation child ASIN,the related VariationParent element is contained in the Relationshipselement.

Note: Because this operation does not return all productattributes, it is possible to get VariationChild elements withdifferent ASIN values but the same variation element values.These are distinct variation child ASINs even though productattributes that differentiate them from each other are notreturned.

Variation attributes can be found in the VariationChild element ofdefault.xsd.

SalesRankings Sales rank information for the product by product category.

Sub-elements are:

• ProductCategoryId. Identifies the product category that the salesrank is taken from.

• Rank. The sales rank of the product within the product category.

Examples

Example query request

https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=ListMatchingProducts&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-12T22%3A23%3A50Z&Version=2011-10-01&Signature=V%2BEXAMPLERT%2Baj%2Fxwqo7y3PIifMFHeqFlNYW0EXAMPLEA%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&Query=0439708184

Example response

<?xml version="1.0"?><ListMatchingProductsResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><ListMatchingProductsResult> <Products xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">



<Product> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>059035342X</ASIN> </MarketplaceASIN> </Identifiers> <AttributeSets> <ns2:ItemAttributes xml:lang="en-US"> <ns2:Author>Rowling, J.K.</ns2:Author> <ns2:Binding>Paperback</ns2:Binding> <ns2:Brand>Scholastic Press</ns2:Brand> <ns2:Creator Role="Illustrator">GrandPré, Mary</ns2:Creator> <ns2:Edition>1st</ns2:Edition> <ns2:Feature>Recommended Age: 9 years and up</ns2:Feature> <ns2:ItemDimensions> <ns2:Height Units="inches">0.80</ns2:Height> <ns2:Length Units="inches">7.50</ns2:Length> <ns2:Width Units="inches">5.20</ns2:Width> <ns2:Weight Units="pounds">0.50</ns2:Weight> </ns2:ItemDimensions> <ns2:IsAutographed>false</ns2:IsAutographed> <ns2:IsMemorabilia>false</ns2:IsMemorabilia> <ns2:Label>Scholastic Paperbacks</ns2:Label> <ns2:Languages> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Unknown</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Original Language</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Published</ns2:Type> </ns2:Language> </ns2:Languages> <ns2:ListPrice> <ns2:Amount>10.99</ns2:Amount> <ns2:CurrencyCode>USD</ns2:CurrencyCode> </ns2:ListPrice> <ns2:Manufacturer>Scholastic Paperbacks</ns2:Manufacturer> <ns2:NumberOfItems>1</ns2:NumberOfItems> <ns2:NumberOfPages>320</ns2:NumberOfPages> <ns2:PackageDimensions> <ns2:Height Units="inches">1.00</ns2:Height> <ns2:Length Units="inches">7.50</ns2:Length> <ns2:Width Units="inches">5.20</ns2:Width> <ns2:Weight Units="pounds">0.50</ns2:Weight> </ns2:PackageDimensions> <ns2:PackageQuantity>1</ns2:PackageQuantity> <ns2:PartNumber>9780590353427</ns2:PartNumber> <ns2:ProductGroup>Book</ns2:ProductGroup> <ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName> <ns2:PublicationDate>1999-10-01</ns2:PublicationDate> <ns2:Publisher>Scholastic Paperbacks</ns2:Publisher> <ns2:ReleaseDate>1999-09-08</ns2:ReleaseDate> <ns2:SmallImage> <ns2:URL>http://ecx.images-amazon.com/images/I/51MU5VilKpL._SL75_.jpg</ns2:URL> <ns2:Height Units="pixels">75</ns2:Height> <ns2:Width Units="pixels">51</ns2:Width> </ns2:SmallImage>



<ns2:Studio>Scholastic Paperbacks</ns2:Studio> <ns2:Title>Harry Potter and the Sorcerer's Stone (Book 1)</ns2:Title> </ns2:ItemAttributes> </AttributeSets> <Relationships/> <SalesRankings> <SalesRank> <ProductCategoryId>book_display_on_website</ProductCategoryId> <Rank>401</Rank> </SalesRank> <SalesRank> <ProductCategoryId>15356791</ProductCategoryId> <Rank>5</Rank> </SalesRank> <SalesRank> <ProductCategoryId>3153</ProductCategoryId> <Rank>8</Rank> </SalesRank> <SalesRank> <ProductCategoryId>17468</ProductCategoryId> <Rank>16</Rank> </SalesRank> </SalesRankings> </Product> </Products></ListMatchingProductsResult><ResponseMetadata> <RequestId>3b805a12-689a-4367-ba86-EXAMPLE91c0b</RequestId></ResponseMetadata></ListMatchingProductsResponse>

Related topicsWhat you should know about the Amazon MWS Products API section



GetMatchingProductReturns a list of products and their attributes, based on a list of ASIN values.

DescriptionThe GetMatchingProduct operation returns a list of products and their attributes, based on a list of ASIN values thatyou specify. This operation returns a maximum of ten products.

Important. All of the functionality of the GetMatchingProduct operation can be found in the newGetMatchingProductForId operation. The GetMatchingProduct operation is included in the Products APIsection for backward compatibility, but you should use the GetMatchingProductForId operation in favor of theGetMatchingProduct operation whenever possible. For more information, see GetMatchingProductForId.



MarketplaceId A marketplace identifier. Specifies the marketplace from whichproducts are returned.

Type: xs:string

Yes

ASINList A structured list of ASIN values. Used to identify products in thegiven marketplace.

Maximum: 10 ASIN values

Yes

Response elementsThe GetMatchingProduct operation returns the same response elements that are described in theListMatchingProducts Response elements section, except that only one Product is returned per ASIN in ASINList.

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetMatchingProduct&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T21%3A01%3A53Z&Version=2011-10-01&Signature=5O%2EXAMPLEtpSD0NbC%2FltDxXuLe2TXAd%2B48AEXAMPLE0%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&ASINList.ASIN.1=B002KT3XRQ



Example response

<?xml version="1.0"?><GetMatchingProductResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetMatchingProductResult ASIN="B002KT3XRQ" status="Success"> <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B002KT3XRQ</ASIN> </MarketplaceASIN> </Identifiers> <AttributeSets> <ns2:ItemAttributes xml:lang="en-US"> <ns2:Binding>Apparel</ns2:Binding> <ns2:Brand>Pearl iZUMi</ns2:Brand> <ns2:Department>mens</ns2:Department> <ns2:Feature>Select transfer fabric sets the benchmark for moisture transfer and four-way performance stretch</ns2:Feature> <ns2:Feature>6-Panel anatomic design for superior, chafe-free comfort, UPF 50+ sun protection</ns2:Feature> <ns2:Feature>Comfortable silicone leg grippers keep shorts in place, moisture-wicking, antimicrobial properties</ns2:Feature> <ns2:Feature>Tour 3D Chamois is male-specific and non-chafing with padding in key areas</ns2:Feature> <ns2:Feature>86 percent nylon, 14% spandex, 9-Inch inseam</ns2:Feature> <ns2:ItemDimensions> <ns2:Height Units="inches">2.00</ns2:Height> <ns2:Length Units="inches">9.00</ns2:Length> <ns2:Width Units="inches">9.00</ns2:Width> </ns2:ItemDimensions> <ns2:Label>Pearl iZUMi</ns2:Label> <ns2:ListPrice> <ns2:Amount>50.00</ns2:Amount> <ns2:CurrencyCode>USD</ns2:CurrencyCode> </ns2:ListPrice> <ns2:Manufacturer>Pearl iZUMi</ns2:Manufacturer> <ns2:Model>0275</ns2:Model> <ns2:PackageDimensions> <ns2:Height Units="inches">2.80</ns2:Height> <ns2:Length Units="inches">9.75</ns2:Length> <ns2:Width Units="inches">8.40</ns2:Width> <ns2:Weight Units="pounds">0.40</ns2:Weight> </ns2:PackageDimensions> <ns2:PackageQuantity>1</ns2:PackageQuantity> <ns2:PartNumber>0275</ns2:PartNumber> <ns2:ProductGroup>Apparel</ns2:ProductGroup> <ns2:ProductTypeName>SHORTS</ns2:ProductTypeName> <ns2:Publisher>Pearl iZUMi</ns2:Publisher> <ns2:SmallImage> <ns2:URL>http://ecx.images-amazon.com/images/I/41ty3Sn%2BU8L._SL75_.jpg</ns2:URL> <ns2:Height Units="pixels">75</ns2:Height> <ns2:Width Units="pixels">58</ns2:Width> </ns2:SmallImage> <ns2:Studio>Pearl iZUMi</ns2:Studio> <ns2:Title>Pearl iZUMi Men's Quest Cycling Short</ns2:Title> </ns2:ItemAttributes> </AttributeSets> <Relationships>



<ns2:VariationChild> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B002KT3XQC</ASIN> </MarketplaceASIN> </Identifiers> <ns2:Color>Black</ns2:Color> <ns2:Size>Small</ns2:Size> </ns2:VariationChild> <ns2:VariationChild> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B002KT3XQW</ASIN> </MarketplaceASIN> </Identifiers> <ns2:Color>Black</ns2:Color> <ns2:Size>Medium</ns2:Size> </ns2:VariationChild> <ns2:VariationChild> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B002KT3XQM</ASIN> </MarketplaceASIN> </Identifiers> <ns2:Color>Black</ns2:Color> <ns2:Size>Large</ns2:Size> </ns2:VariationChild> <ns2:VariationChild> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B002KT3XR6</ASIN> </MarketplaceASIN> </Identifiers> <ns2:Color>Black</ns2:Color> <ns2:Size>X-Large</ns2:Size> </ns2:VariationChild> <ns2:VariationChild> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B002KT3XRG</ASIN> </MarketplaceASIN> </Identifiers> <ns2:Color>Black</ns2:Color> <ns2:Size>XX-Large</ns2:Size> </ns2:VariationChild> </Relationships> <SalesRankings> <SalesRank> <ProductCategoryId>apparel_display_on_website</ProductCategoryId> <Rank>159</Rank> </SalesRank> <SalesRank> <ProductCategoryId>2420095011</ProductCategoryId> <Rank>1</Rank> </SalesRank> <SalesRank> <ProductCategoryId>2611189011</ProductCategoryId> <Rank>4</Rank> </SalesRank>



</SalesRankings> </Product></GetMatchingProductResult><ResponseMetadata> <RequestId>b12caada-d330-4d87-a789-EXAMPLE35872</RequestId></ResponseMetadata></GetMatchingProductResponse>




GetMatchingProductForIdReturns a list of products and their attributes, based on a list of ASIN, GCID, SellerSKU, UPC, EAN, ISBN, and JANvalues.

DescriptionThe GetMatchingProductForId operation returns a list of products and their attributes, based on a list of productidentifier values that you specify. Possible product identifiers are ASIN, GCID, SellerSKU, UPC, EAN, ISBN, andJAN.



MarketplaceId A marketplace identifier. Specifies themarketplace from which products are returned.

Type: xs:string

Yes

IdType The type of product identifier that Id valuesrefer to. Valid values are ASIN, GCID,SellerSKU, UPC, EAN, ISBN, and JAN.

Type: xs:string

Yes

IdList A structured list of Id values. Used to identifyproducts in the given marketplace.

Maximum: Five Id values

Yes

Response elementsThe GetMatchingProductForId operation returns the same response elements that are described in theListMatchingProducts Response elements section, except that only one Product is returned per Id in IdList.

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetMatchingProductForId&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T21%3A09%3A02Z&Version=2011-10-01&Signature=ZhhdEXAMPLEiTy6k5etzw%2BIOCvbDrGop5u9EXAMPLE8%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&IdType=ISBN&IdList.Id.1=9781933988665



&IdList.Id.2=0439708184

Example response

<?xml version="1.0"?><GetMatchingProductForIdResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetMatchingProductForIdResult Id="9781933988665" IdType="ISBN" status="Success"> <Products xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Product> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>1933988665</ASIN> </MarketplaceASIN> </Identifiers> <AttributeSets> <ns2:ItemAttributes xml:lang="en-US"> <ns2:Author>Marmanis, Haralambos</ns2:Author> <ns2:Author>Babenko, Dmitry</ns2:Author> <ns2:Binding>Paperback</ns2:Binding> <ns2:Edition>1</ns2:Edition> <ns2:ItemDimensions> <ns2:Height Units="inches">9.17</ns2:Height> <ns2:Length Units="inches">7.36</ns2:Length> <ns2:Width Units="inches">0.75</ns2:Width> <ns2:Weight Units="pounds">1.40</ns2:Weight> </ns2:ItemDimensions> <ns2:IsEligibleForTradeIn>true</ns2:IsEligibleForTradeIn> <ns2:Label>Manning Publications</ns2:Label> <ns2:Languages> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Unknown</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Original Language</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Published</ns2:Type> </ns2:Language> </ns2:Languages> <ns2:ListPrice> <ns2:Amount>44.99</ns2:Amount> <ns2:CurrencyCode>USD</ns2:CurrencyCode> </ns2:ListPrice> <ns2:Manufacturer>Manning Publications</ns2:Manufacturer> <ns2:NumberOfItems>1</ns2:NumberOfItems> <ns2:NumberOfPages>368</ns2:NumberOfPages> <ns2:PackageDimensions> <ns2:Height Units="inches">0.80</ns2:Height> <ns2:Length Units="inches">9.10</ns2:Length> <ns2:Width Units="inches">7.30</ns2:Width> <ns2:Weight Units="pounds">1.35</ns2:Weight> </ns2:PackageDimensions> <ns2:ProductGroup>Book</ns2:ProductGroup> <ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName> <ns2:PublicationDate>2009-07-05</ns2:PublicationDate>



<ns2:Publisher>Manning Publications</ns2:Publisher> <ns2:SmallImage> <ns2:URL>http://ecx.images-amazon.com/images/I/51EEz05N2HL._SL75_.jpg</ns2:URL> <ns2:Height Units="pixels">75</ns2:Height> <ns2:Width Units="pixels">60</ns2:Width> </ns2:SmallImage> <ns2:Studio>Manning Publications</ns2:Studio> <ns2:Title>Algorithms of the Intelligent Web</ns2:Title> </ns2:ItemAttributes> </AttributeSets> <Relationships/> <SalesRankings> <SalesRank> <ProductCategoryId>book_display_on_website</ProductCategoryId> <Rank>59485</Rank> </SalesRank> <SalesRank> <ProductCategoryId>377886011</ProductCategoryId> <Rank>32</Rank> </SalesRank> <SalesRank> <ProductCategoryId>3887</ProductCategoryId> <Rank>66</Rank> </SalesRank> <SalesRank> <ProductCategoryId>3870</ProductCategoryId> <Rank>82</Rank> </SalesRank> </SalesRankings> </Product> </Products></GetMatchingProductForIdResult><GetMatchingProductForIdResult Id="0439708184" IdType="ISBN" status="Success"> <Products xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Product> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>059035342X</ASIN> </MarketplaceASIN> </Identifiers> <AttributeSets> <ns2:ItemAttributes xml:lang="en-US"> <ns2:Author>Rowling, J.K.</ns2:Author> <ns2:Binding>Paperback</ns2:Binding> <ns2:Brand>Scholastic Press</ns2:Brand> <ns2:Creator Role="Illustrator">GrandPré, Mary</ns2:Creator> <ns2:Edition>1st</ns2:Edition> <ns2:Feature>Recommended Age: 9 years and up</ns2:Feature> <ns2:ItemDimensions> <ns2:Height Units="inches">0.80</ns2:Height> <ns2:Length Units="inches">7.50</ns2:Length> <ns2:Width Units="inches">5.20</ns2:Width> <ns2:Weight Units="pounds">0.50</ns2:Weight> </ns2:ItemDimensions> <ns2:IsAutographed>false</ns2:IsAutographed> <ns2:IsMemorabilia>false</ns2:IsMemorabilia> <ns2:Label>Scholastic Paperbacks</ns2:Label> <ns2:Languages> <ns2:Language>



<ns2:Name>english</ns2:Name> <ns2:Type>Unknown</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Original Language</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Published</ns2:Type> </ns2:Language> </ns2:Languages> <ns2:ListPrice> <ns2:Amount>10.99</ns2:Amount> <ns2:CurrencyCode>USD</ns2:CurrencyCode> </ns2:ListPrice> <ns2:Manufacturer>Scholastic Paperbacks</ns2:Manufacturer> <ns2:NumberOfItems>1</ns2:NumberOfItems> <ns2:NumberOfPages>320</ns2:NumberOfPages> <ns2:PackageDimensions> <ns2:Height Units="inches">1.00</ns2:Height> <ns2:Length Units="inches">7.50</ns2:Length> <ns2:Width Units="inches">5.20</ns2:Width> <ns2:Weight Units="pounds">0.50</ns2:Weight> </ns2:PackageDimensions> <ns2:PackageQuantity>1</ns2:PackageQuantity> <ns2:PartNumber>9780590353427</ns2:PartNumber> <ns2:ProductGroup>Book</ns2:ProductGroup> <ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName> <ns2:PublicationDate>1999-10-01</ns2:PublicationDate> <ns2:Publisher>Scholastic Paperbacks</ns2:Publisher> <ns2:ReleaseDate>1999-09-08</ns2:ReleaseDate> <ns2:SmallImage> <ns2:URL>http://ecx.images-amazon.com/images/I/51MU5VilKpL._SL75_.jpg</ns2:URL> <ns2:Height Units="pixels">75</ns2:Height> <ns2:Width Units="pixels">51</ns2:Width> </ns2:SmallImage> <ns2:Studio>Scholastic Paperbacks</ns2:Studio> <ns2:Title>Harry Potter and the Sorcerer's Stone (Book 1)</ns2:Title> </ns2:ItemAttributes> </AttributeSets> <Relationships/> <SalesRankings> <SalesRank> <ProductCategoryId>book_display_on_website</ProductCategoryId> <Rank>362</Rank> </SalesRank> <SalesRank> <ProductCategoryId>15356791</ProductCategoryId> <Rank>6</Rank> </SalesRank> <SalesRank> <ProductCategoryId>3153</ProductCategoryId> <Rank>9</Rank> </SalesRank> <SalesRank> <ProductCategoryId>3045</ProductCategoryId> <Rank>14</Rank> </SalesRank> </SalesRankings> </Product> <Product>



<Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>0439708184</ASIN> </MarketplaceASIN> </Identifiers> <AttributeSets> <ns2:ItemAttributes xml:lang="en-US"> <ns2:Author>J.K. Rowling, Mary GrandPrÃ©</ns2:Author> <ns2:Binding>Paperback</ns2:Binding> <ns2:Label>Scholastic Paperbacks</ns2:Label> <ns2:Languages> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Unknown</ns2:Type> </ns2:Language> <ns2:Language> <ns2:Name>english</ns2:Name> <ns2:Type>Published</ns2:Type> </ns2:Language> </ns2:Languages> <ns2:Manufacturer>Scholastic Paperbacks</ns2:Manufacturer> <ns2:NumberOfItems>1</ns2:NumberOfItems> <ns2:NumberOfPages>784</ns2:NumberOfPages> <ns2:PackageDimensions> <ns2:Height Units="inches">0.73</ns2:Height> <ns2:Length Units="inches">8.43</ns2:Length> <ns2:Width Units="inches">5.85</ns2:Width> <ns2:Weight Units="pounds">0.79</ns2:Weight> </ns2:PackageDimensions> <ns2:ProductGroup>Book</ns2:ProductGroup> <ns2:ProductTypeName>BOOKS_1973_AND_LATER</ns2:ProductTypeName> <ns2:PublicationDate>1999-09-08</ns2:PublicationDate> <ns2:Publisher>Scholastic Paperbacks</ns2:Publisher> <ns2:SmallImage> <ns2:URL>http://ecx.images-amazon.com/images/I/51STfI7UiCL._SL75_.jpg</ns2:URL> <ns2:Height Units="pixels">75</ns2:Height> <ns2:Width Units="pixels">52</ns2:Width> </ns2:SmallImage> <ns2:Studio>Scholastic Paperbacks</ns2:Studio> <ns2:Title>Harry Potter and the Sorcerer's Stone</ns2:Title> </ns2:ItemAttributes> </AttributeSets> <Relationships/> <SalesRankings> <SalesRank> <ProductCategoryId>book_display_on_website</ProductCategoryId> <Rank>2091024</Rank> </SalesRank> </SalesRankings> </Product> </Products></GetMatchingProductForIdResult><ResponseMetadata> <RequestId>7ba3245e-a213-430a-bea9-EXAMPLE38d76</RequestId></ResponseMetadata></GetMatchingProductForIdResponse>




GetCompetitivePricingForSKUReturns the current competitive price of a product, based on SellerSKU.

DescriptionThe GetCompetitivePricingForSKU operation returns the current competitive pricing of a product, based on theSellerSKU and MarketplaceId that you specify. Note that SellerSKU is qualified by your SellerId, which is includedwith every Amazon Marketplace Web Service (Amazon MWS) operation that you submit. This operation returnspricing for active offer listings based on two pricing models: New Buy Box Price and Used Buy Box Price. Thesepricing models are equivalent to the main Buy Box Price and the subordinate Buy Box Price, respectively, on a detailpage from an Amazon marketplace website. Note that products with active offer listings might not return either of theseprices. This could happen, for example, if none of the sellers with offer listings for a product are qualified for the NewBuy Box or the Used Buy Box. Also note that your own price for the SellerSKU that you specify is not excluded fromthe response, so your price will be returned if it is the lowest listed price. The number of offer listings, the trade-invalue, and the sales rankings for the SellerSKU that you specify are also returned.

Note: If you specify a SellerSKU that identifies a variation parent ASIN, this operation returns an error.A variation parent ASIN represents a generic product that cannot be sold. Variation child ASINs representproducts that have specific characteristics (such as size and color) and can be sold.



MarketplaceId A marketplace identifier. Specifies the marketplace from whichprices are returned.

Type: xs:string

Yes

SellerSKUList A structured list of SellerSKU values. Used to identify products inthe given marketplace. SellerSKU is qualified by your SellerId,which is included with every Amazon Marketplace Web Service(Amazon MWS) operation that you submit.

Maximum: 20 SellerSKU values

Yes

Response elementsThe response elements that the GetCompetitivePricingForSKU operation returns are described by the followingpublicly available XSD: Product.xsd. The following table provides additional information about some of the keyelements that are returned by the GetCompetitivePricingForSKU operation.

Name Description

Product Contains three of the sub-elements of the Product element fromProduct.xsd. These sub-elements are: Identifiers, CompetitivePricing,and SalesRankings.

Identifiers Contains the following identifiers that uniquely identify a product:

• MarketplaceASIN – MarketplaceId and ASIN combination.• SKUIdentifier – MarketplaceId, SellerSKU, and SellerId

combination.




Name Description

CompetitivePricing Contains pricing information for the product that is returned.

Some key sub-elements are:

• CompetitivePrice. Contains pricing information. TheCompetitivePrice element contains the following attributes:

• condition. Indicates the condition of the item whose pricinginformation is returned. Possible values are: New, Used,Collectible, Refurbished, and Club.

• subcondition. Indicates the subcondition of the item whosepricing information is returned. Possible values are: New, Mint,Very Good, Good, Acceptable, Poor, Club, OEM, Warranty,Refurbished Warranty, Refurbished, Open Box, and Other.

• belongsToRequester. Indicates whether or not the pricinginformation is for an offer listing that belongs to the requester.The requester is the seller associated with the SellerId that wassubmitted with the request. Possible values are: true and false.

• CompetitivePriceId. The pricing model for each price that isreturned. Valid values: 1, 2. Value definitions: 1 = New Buy BoxPrice, 2 = Used Buy Box Price.

• Price. Pricing information for a given CompetitivePriceId value.Includes the listing price, and optionally the shipping cost and thelanded price (listing price plus the shipping cost). Note that theshipping cost might not always be available.

• NumberOfOfferListings. The number of active offer listings forthe product that was submitted. The listing count is returned bycondition, in OfferListingCount sub-elements, one for each listingcondition value that is returned. Possible listing condition valuesare: Any, New, Used, Collectible, Refurbished, and Club.

• TradeInValue. The trade-in value of the product in Amazon’sTrade-In program. For more information about Amazon’s Trade-Inprogram, see the “Amazon Trade-In program” section of the Helppages for the Amazon website in your marketplace.

SalesRankings Sales rank information for the product by product category.

Key sub-elements are:

• ProductCategoryId. Identifies the product category that the salesrank is taken from.

• Rank. The sales rank of the product within the product category.

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetCompetitivePricingForSKU&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T21%3A14%3A27Z&Version=2011-10-01&Signature=wJI6EXAMPLE2Bfa46Ej%2BD1NwsIG%2Bjdyp828HHEXAMPLEY%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&SellerSKUList.SellerSKU.1=SKU2468

Example response

<?xml version="1.0"?>



<GetCompetitivePricingForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetCompetitivePricingForSKUResult SellerSKU="SKU2468" status="Success"> <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>1933890517</ASIN> </MarketplaceASIN> <SKUIdentifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <SellerId>A1IMEXAMPLEWRC</SellerId> <SellerSKU>SKU2468</SellerSKU> </SKUIdentifier> </Identifiers> <CompetitivePricing> <CompetitivePrices> <CompetitivePrice belongsToRequester="false" condition="New" subcondition="New"> <CompetitivePriceId>1</CompetitivePriceId> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>40.03</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>40.03</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </Price> </CompetitivePrice> <CompetitivePrice belongsToRequester="false" condition="Used" subcondition="Good"> <CompetitivePriceId>2</CompetitivePriceId> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>30.50</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>30.50</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </Price> </CompetitivePrice> </CompetitivePrices> <NumberOfOfferListings> <OfferListingCount condition="Any">296</OfferListingCount> <OfferListingCount condition="Used">145</OfferListingCount> <OfferListingCount condition="New">151</OfferListingCount> </NumberOfOfferListings> <TradeInValue> <CurrencyCode>USD</CurrencyCode> <Amount>17.05</Amount>



</TradeInValue> </CompetitivePricing> <SalesRankings> <SalesRank> <ProductCategoryId>book_display_on_website</ProductCategoryId> <Rank>900</Rank> </SalesRank> <SalesRank> <ProductCategoryId>271578011</ProductCategoryId> <Rank>1</Rank> </SalesRank> <SalesRank> <ProductCategoryId>355562011</ProductCategoryId> <Rank>8</Rank> </SalesRank> <SalesRank> <ProductCategoryId>173516</ProductCategoryId> <Rank>25</Rank> </SalesRank> </SalesRankings> </Product></GetCompetitivePricingForSKUResult><ResponseMetadata> <RequestId>003fc73e-bf70-4e55-8db8-EXAMPLEce417</RequestId></ResponseMetadata></GetCompetitivePricingForSKUResponse>




GetCompetitivePricingForASINReturns the current competitive price of a product, based on ASIN.

DescriptionThe GetCompetitivePricingForASIN operation is the same as the GetCompetitivePricingForSKUoperation, except that it uses a MarketplaceId and an ASIN to uniquely identify a product, and it does notreturn the SKUIdentifier element. If you do not have the ASIN for a product, you will first have to submit theListMatchingProducts operation for disambiguation.




Type: xs:string

Yes


Maximum: 20 ASIN values

Yes

Response elementsThe GetCompetitivePricingForASIN operation returns the same response elements that are described in theGetCompetitivePricingForSKU Response elements section, except that it does not return the SKUIdentifierelement.

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetCompetitivePricingForASIN&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T21%3A23%3A31Z&Version=2011-10-01&Signature=V1uTEXAMPLE8HVCfobAqQDKzylYyTRWfv3X4SEXAMPLEY%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&ASINList.ASIN.1=B002KT3XQM

Example response

<?xml version="1.0"?>



<GetCompetitivePricingForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetCompetitivePricingForASINResult ASIN="B002KT3XQM" status="Success"> <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B002KT3XQM</ASIN> </MarketplaceASIN> </Identifiers> <CompetitivePricing> <CompetitivePrices> <CompetitivePrice belongsToRequester="false" condition="New" subcondition="New"> <CompetitivePriceId>1</CompetitivePriceId> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>34.27</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>34.27</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </Price> </CompetitivePrice> </CompetitivePrices> <NumberOfOfferListings> <OfferListingCount condition="Any">11</OfferListingCount> <OfferListingCount condition="Used">1</OfferListingCount> <OfferListingCount condition="New">10</OfferListingCount> </NumberOfOfferListings> </CompetitivePricing> <SalesRankings/> </Product></GetCompetitivePricingForASINResult><ResponseMetadata> <RequestId>a8ec20c3-fc88-46e3-a128-EXAMPLE3fcdf</RequestId></ResponseMetadata></GetCompetitivePricingForASINResponse>




GetLowestOfferListingsForSKUReturns pricing information for the lowest-price active offer listings for a product, based on SellerSKU.

DescriptionThe GetLowestOfferListingsForSKU operation returns the lowest price offer listings for a specific product by itemcondition. The listings for the specified product and ItemCondition are placed in offer listing groups, each grouprepresenting a different combination of the following six qualifiers:

• ItemCondition (New, Used, Collectible, Refurbished, or Club)• ItemSubcondition (New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished

Warranty, Refurbished, Open Box, or Other)• FulfillmentChannel (Amazon or Merchant)• ShipsDomestically (True, False, or Unknown) – Indicates whether the marketplace specified in the request and the

location that the item ships from are in the same country.• ShippingTime (0-2 days, 3-7 days, 8-13 days, or 14 or more days) – Indicates the maximum time within which the

item will likely be shipped once an order has been placed• SellerPositiveFeedbackRating (98-100%, 95-97%, 90-94%, 80-89%, 70-79%, Less than 70%, or Just launched )

– Indicates the percentage of feedback ratings that were positive over the past 12 months.

Some (but not necessarily all) of the active offer listings for the specified product and ItemCondition, initially sortedby the lowest landed price, are placed into their corresponding offer listing groups, and the listing with the lowestlanded price from each group is returned. If multiple sellers have listings that share the lowest landed price for a group,the listing from the seller with the highest feedback count is returned. Groups without any listings are not returned.

This operation returns the AllOfferListingsConsidered response element, which indicates whether or not all of theactive offer listings for the specified product and ItemCondition were considered when the listings were placed intotheir corresponding offer listing groups. Note that even if not all the listings were considered, you can still expect thefollowing:

• The lowest landed prices that are returned will be the lowest landed prices from their respective offer listing groups.• The lowest landed prices that are returned will be lower than the landed prices for any listings that were not

considered.

Note: When you submit the GetLowestOfferListingsForSKU operation, your own offer listings areincluded in the response unless you use the ExcludeMe request parameter with a value of True.

Note: Instead of calling the GetLowestOfferListingsForSKU operation to obtain the lowest price offerlistings for a specific product by item condition, consider subscribing to the AnyOfferChanged notificationby using the Subscriptions API section. When you subscribe to this notification, you will be notified wheneverthere is a price change or offer listing change for any of the top 20 offers, by condition (new or used), for anitem that you sell. For more information, see the Subscriptions API section reference.




Type: xs:string

Yes




SellerSKUList A structured list of SellerSKU values. Used to identify products inthe given marketplace. SellerSKU is qualified by your SellerId,which is included with every Amazon Marketplace Web Service(Amazon MWS) operation that you submit.

Maximum: 20 SellerSKU values.

Yes

ItemCondition Filters the offer listings to be considered based on item condition.

Valid values: Any, New, Used, Collectible, Refurbished, and Club.

Optional

No

Default: Any

ExcludeMe Excludes your own offer listings from the offer listings that arereturned.

Valid values:

• True – Your own offer listings are excluded from the offerlistings that are returned.

• False – Your own offer listings are included in the offerlistings that are returned.

Optional

No

Default: False

Response elementsThe GetLowestOfferListingsForSKU operation returns the Product response element that is described by thefollowing publically available XSDs: Product.xsd and default.xsd. The GetLowestOfferListingsForSKU operationreturns the following two sub-elements of the Products response element: Identifiers and LowestOfferListings.

Name Description

AllOfferListingsConsidered Indicates whether or not all of the active offer listings for the specifiedproduct and ItemCondition were considered when the listings wereplaced into their corresponding offer listing groups. When there area large number of active offer listings for the specified product andItemCondition, only a certain number of offer listings are considered.The listings that are considered always have lower landed prices thanthe landed prices of listings that are not considered.

Product Contains two of the sub-elements of the Product elementfrom Product.xsd. These sub-elements are: Identifiers andLowestOfferListings.



combination.

LowestOfferListings Contains pricing information for the lowest offer listing for each offerlisting group.

Some key sub-elements are:

• Qualifiers. Contains the following six qualifiers: ItemCondition,ItemSubcondition, FulfillmentChannel, ShipsDomestically,ShippingTime, and SellerPositiveFeedbackRating. Thesequalifiers identify the offer listing group from which the lowestoffer listing was taken.

• NumberOfOfferListingsConsidered. Of the offer listingsconsidered, this number indicates how many belonged to thisoffer listing group. Note that if AllOfferListingsConsideredis returned with a value of True, then the value ofNumberOfOfferListingsConsidered is the actual number ofactive offer listings that met the six qualifying criteria of the offerlisting group. However if AllOfferListingsConsidered is returnedwith a value of False, then the actual number might be higher.


http://g-ecx.images-amazon.com/images/G/01/mwsportal/doc/en_US/products/default.xsd



Name Description

• SellerFeedbackCount. The number of seller feedback ratingsthat have been submitted for the seller with the lowest-priced offerlisting in the group.

• Price. Pricing information for the lowest offer listing in the group.Includes the listing price, and optionally, the shipping cost and thelanded price (listing price plus the shipping cost). Note that if thelanded price is not returned, the listing price represents the productwith the lowest landed price.

• MultipleOfferListingsAtLowestPrice. Indicates if there is morethan one listing with the lowest listing price in the group.

Valid values:

• True – There is more than one listing with the lowest listingprice in the group.

• False – There is only one listing with the lowest listing price inthe group.

• Unknown – The service cannot determine if there is more thanone listing with the lowest listing price in the group. This canhappen in certain cases when not all active offer listings wereconsidered when the offer listings were sorted into groups(when AllOfferListingsConsidered = False).

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetLowestOfferListingsForSKU&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T21%3A53%3A02Z&Version=2011-10-01&Signature=FUcIEXAMPLETUGtTS6sqNDt3OuLH8tbhz5YEXAMPLEw%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&ExcludeMe=false&SellerSKUList.SellerSKU.1=SKU2468

Example response

<?xml version="1.0"?><GetLowestOfferListingsForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetLowestOfferListingsForSKUResult SellerSKU="SKU2468" status="Success"> <AllOfferListingsConsidered>false</AllOfferListingsConsidered> <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>1933890517</ASIN> </MarketplaceASIN> <SKUIdentifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <SellerId>A1IMEXAMPLEWRC</SellerId> <SellerSKU>SKU2468</SellerSKU> </SKUIdentifier> </Identifiers>



<LowestOfferListings> <LowestOfferListing> <Qualifiers> <ItemCondition>Used</ItemCondition> <ItemSubcondition>Acceptable</ItemSubcondition> <FulfillmentChannel>Merchant</FulfillmentChannel> <ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating> </Qualifiers> <NumberOfOfferListingsConsidered>3</NumberOfOfferListingsConsidered> <SellerFeedbackCount>8900</SellerFeedbackCount> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>28.68</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>24.69</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>3.99</Amount> </Shipping> </Price> <MultipleOffersAtLowestPrice>True</MultipleOffersAtLowestPrice> </LowestOfferListing> <LowestOfferListing> <Qualifiers> <ItemCondition>Used</ItemCondition> <ItemSubcondition>Good</ItemSubcondition> <FulfillmentChannel>Amazon</FulfillmentChannel> <ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>90-94%</SellerPositiveFeedbackRating> </Qualifiers> <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered> <SellerFeedbackCount>1569694</SellerFeedbackCount> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>30.50</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>30.50</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </Price> <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice> </LowestOfferListing> <LowestOfferListing> <Qualifiers> <ItemCondition>Used</ItemCondition> <ItemSubcondition>Good</ItemSubcondition> <FulfillmentChannel>Merchant</FulfillmentChannel>



<ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating> </Qualifiers> <NumberOfOfferListingsConsidered>3</NumberOfOfferListingsConsidered> <SellerFeedbackCount>7732</SellerFeedbackCount> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>30.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>27.00</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>3.99</Amount> </Shipping> </Price> <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice> </LowestOfferListing> </LowestOfferListings> </Product></GetLowestOfferListingsForSKUResult><ResponseMetadata> <RequestId>8106ed19-9a90-4820-881e-EXAMPLE0ab97</RequestId></ResponseMetadata></GetLowestOfferListingsForSKUResponse>




GetLowestOfferListingsForASINReturns pricing information for the lowest-price active offer listings for a product, based on ASIN.

DescriptionThe GetLowestOfferListingsForASIN operation is the same as the GetLowestOfferListingsForSKU operationexcept that it uses a MarketplaceId and an ASIN to uniquely identify a product, and it does not return theSKUIdentifier element.

Note: Instead of calling the GetLowestOfferListingsForASIN operation to obtain the lowest price offerlistings for a specific product by item condition, consider subscribing to the AnyOfferChanged notificationby using the Subscriptions API section. When you subscribe to this notification, you will be notified wheneverthere is a price change or offer listing change for any of the top 20 offers, by condition (new or used), for anitem that you sell. For more information, see the Subscriptions API section reference.




Type: xs:string

Yes


Maximum: 20 ASIN values.

Yes

ItemCondition Filters the offer listings to be considered based on item condition.Valid values: New, Used, Collectible, Refurbished, Club.

Optional

No

Default: All

Response elementsThe GetLowestOfferListingsForASIN operation returns the same response elements that are described in theGetLowestOfferListingForSKU Response elements section, except that it does not return the SKUIdentifierelement.

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetLowestOfferListingsForASIN&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T22%3A03%3A05Z&Version=2011-10-01



&Signature=fJFzEXAMPLEEax1vAdKP7l3lwKQUH1r34lcEXAMPLEA%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&ASINList.ASIN.1=B002KT3XQM

Example response

<?xml version="1.0"?><GetLowestOfferListingsForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetLowestOfferListingsForASINResult ASIN="B002KT3XQM" status="Success"> <AllOfferListingsConsidered>true</AllOfferListingsConsidered> <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B002KT3XQM</ASIN> </MarketplaceASIN> </Identifiers> <LowestOfferListings> <LowestOfferListing> <Qualifiers> <ItemCondition>Used</ItemCondition> <ItemSubcondition>VeryGood</ItemSubcondition> <FulfillmentChannel>Merchant</FulfillmentChannel> <ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>90-94%</SellerPositiveFeedbackRating> </Qualifiers> <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered> <SellerFeedbackCount>762</SellerFeedbackCount> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>28.00</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>4.99</Amount> </Shipping> </Price> <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice> </LowestOfferListing> <LowestOfferListing> <Qualifiers> <ItemCondition>New</ItemCondition> <ItemSubcondition>New</ItemSubcondition> <FulfillmentChannel>Amazon</FulfillmentChannel> <ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>98-100%</SellerPositiveFeedbackRating> </Qualifiers>



<NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered> <SellerFeedbackCount>181744</SellerFeedbackCount> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>34.27</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>34.27</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </Price> <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice> </LowestOfferListing> <LowestOfferListing> <Qualifiers> <ItemCondition>New</ItemCondition> <ItemSubcondition>New</ItemSubcondition> <FulfillmentChannel>Amazon</FulfillmentChannel> <ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating> </Qualifiers> <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered> <SellerFeedbackCount>13213</SellerFeedbackCount> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>41.18</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>41.18</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </Price> <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice> </LowestOfferListing> </LowestOfferListings> </Product></GetLowestOfferListingsForASINResult><ResponseMetadata> <RequestId>60979901-82af-457b-8bdd-EXAMPLE28478</RequestId></ResponseMetadata></GetLowestOfferListingsForASINResponse>




GetMyPriceForSKUReturns pricing information for your own offer listings, based on SellerSKU.

DescriptionThe GetMyPriceForSKU operation returns pricing information for your own offer listings, based on the SellerSKU andMarketplaceId that you specify. Note that if you submit a SellerSKU for a product for which you don’t have an offerlisting, the operation returns an empty Offers element. This operation returns pricing information for a maximum of 20offer listings.



MarketplaceId A marketplace identifier. Specifies themarketplace from which offer listings arereturned.

Type: xs:string

Yes

SellerSKUList A structured list of SellerSKU values. Usedto identify products in the given marketplace.SellerSKU is qualified by your SellerId,which is included with every AmazonMarketplace Web Service (Amazon MWS)operation that you submit.

Maximum: 20 SellerSKU values

Yes

ItemCondition Filters the offer listings to be considered basedon item condition. Valid values: New, Used,Collectible, Refurbished, Club

Optional

No

Default: All

Response elementsThe response elements that the GetMyPriceForSKU operation returns are described by the following publicly availableXSD: Product.xsd. The following table provides additional information about some of the key elements that arereturned by the GetMyPriceForSKU operation.

Name Description



combination.

BuyingPrice Contains pricing information that includes promotions and contains theshipping cost.

Contains the following elements:

• ListingPrice – The current price including any promotions thatapply to the product.

• Shipping – The shipping cost of the product.




Name Description

• LandedPrice – ListingPrice plus Shipping.

RegularPrice The current price excluding any promotions that apply to the product.Excludes the shipping cost.

FulfillmentChannel The fulfillment channel for the offer listing.

Valid values:

• Amazon - Fulfilled by Amazon.• Merchant - Fulfilled by the seller.

ItemCondition The item condition for the offer listing. Valid values: New, Used,Collectible, Refurbished, Club

ItemSubCondition The item subcondition for the offer listing. Valid values: New,Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty,Refurbished Warranty, Refurbished, Open Box, or Other.

SellerId The SellerId submitted with the operation.

SellerSKU The SellerSKU for the offer listing.

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetMyPriceForSKU&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T22%3A08%3A04Z&Version=2011-10-01&Signature=%2B0EXAMPLEuiHJv7xLyYVBgLQa17eJtmP4MIEXAMPLE0%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&SellerSKUList.SellerSKU.1=SKU2468

Example response

<?xml version="1.0"?><GetMyPriceForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetMyPriceForSKUResult SellerSKU="SKU2468" status="Success"> <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>1933890517</ASIN> </MarketplaceASIN> <SKUIdentifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <SellerId>A1IMEXAMPLEWRC</SellerId> <SellerSKU>SKU2468</SellerSKU> </SKUIdentifier> </Identifiers> <Offers> <Offer> <BuyingPrice>



<LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>303.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>300.00</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>3.99</Amount> </Shipping> </BuyingPrice> <RegularPrice> <CurrencyCode>USD</CurrencyCode> <Amount>300.00</Amount> </RegularPrice> <FulfillmentChannel>MERCHANT</FulfillmentChannel> <ItemCondition>Used</ItemCondition> <ItemSubCondition>Acceptable</ItemSubCondition> <SellerId>A1IMEXAMPLEWRC</SellerId> <SellerSKU>SKU2468</SellerSKU> </Offer> </Offers> </Product></GetMyPriceForSKUResult><ResponseMetadata> <RequestId>bc6e4601-3d74-4612-adcf-EXAMPLEf1796</RequestId></ResponseMetadata></GetMyPriceForSKUResponse>




GetMyPriceForASINReturns pricing information for your own offer listings, based on ASIN.

DescriptionThe GetMyPriceForASIN operation is the same as the GetMyPriceForSKU operation except that it uses aMarketplaceId and an ASIN to uniquely identify a product, and it does not return the SKUIdentifier element.



MarketplaceId A marketplace identifier. Specifies themarketplace from which prices are returned.

Type: xs:string

Yes

ASINList A structured list of ASIN values. Used toidentify products in the given marketplace.

Maximum: 20 ASIN values.

Yes

ItemCondition Filters the offer listings to be considered basedon item condition. Valid values: New, Used,Collectible, Refurbished, Club

Optional

No

Default: All

Response elementsThe GetMyPriceForASIN operation returns the same response elements that are described in the GetMyPriceForSKUResponse elements section, except that it does not return the SKUIdentifier element.

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetMyPriceForASIN&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T22%3A40%3A47Z&Version=2011-10-01&Signature=x%2FEXAMPLEFSPqX7tAN83%2FROsuHWc04SEaepLkEXAMPLEo%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&ASINList.ASIN.1=1933890517



Example response

<?xml version="1.0"?><GetMyPriceForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetMyPriceForASINResult ASIN="1933890517" status="Success"> <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd"> <Identifiers> <MarketplaceASIN> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>1933890517</ASIN> </MarketplaceASIN> </Identifiers> <Offers> <Offer> <BuyingPrice> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>303.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>300.00</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>3.99</Amount> </Shipping> </BuyingPrice> <RegularPrice> <CurrencyCode>USD</CurrencyCode> <Amount>300.00</Amount> </RegularPrice> <FulfillmentChannel>MERCHANT</FulfillmentChannel> <ItemCondition>Used</ItemCondition> <ItemSubCondition>Acceptable</ItemSubCondition> <SellerId>A1IMEXAMPLEWRC</SellerId> <SellerSKU>SKU2468</SellerSKU> </Offer> </Offers> </Product></GetMyPriceForASINResult><ResponseMetadata> <RequestId>a3381684-87bd-416e-9b95-EXAMPLE9c236</RequestId></ResponseMetadata></GetMyPriceForASINResponse>




GetProductCategoriesForSKUReturns the parent product categories that a product belongs to, based on SellerSKU.

DescriptionThe GetProductCategoriesForSKU operation returns the product category name and identifier that a product belongsto, including parent categories back to the root for the marketplace.



MarketplaceId A marketplace identifier. Specifies the marketplace from whichcategory structures are returned.

Type: xs:string

Yes

SellerSKU Used to identify products in the given marketplace. SellerSKU isqualified by your SellerId, which is included with every AmazonMarketplace Web Service (Amazon MWS) operation that yousubmit.

Type: xs:string

Yes

Response elementsName Description

Self Contains the ProductCategoryId for the product that you submitted. Also contains aProductCategoryId for each of the parent categories of the product, up to the root for theMarketplace.

ProductCategoryId Identifier for a product category (or browse node).

ProductCategoryName Name of a product category (or browse node).

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetProductCategoriesForSKU&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T22%3A48%3A25Z&Version=2011-10-01&Signature=nLBMEXAMPLE6ASMKD1YTcNk7E8vW6Qzha8cEXAMPLEY%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&SellerSKU=SKU2468



Example response

<?xml version="1.0"?><GetProductCategoriesForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetProductCategoriesForSKUResult> <Self> <ProductCategoryId>271578011</ProductCategoryId> <ProductCategoryName>Project Management</ProductCategoryName> <Parent> <ProductCategoryId>2675</ProductCategoryId> <ProductCategoryName>Management & Leadership</ProductCategoryName> <Parent> <ProductCategoryId>3</ProductCategoryId> <ProductCategoryName>Business & Investing</ProductCategoryName> <Parent> <ProductCategoryId>1000</ProductCategoryId> <ProductCategoryName>Subjects</ProductCategoryName> <Parent> <ProductCategoryId>283155</ProductCategoryId> <ProductCategoryName>Subjects</ProductCategoryName> </Parent> </Parent> </Parent> </Parent> </Self> <Self> <ProductCategoryId>684248011</ProductCategoryId> <ProductCategoryName>Management</ProductCategoryName> <Parent> <ProductCategoryId>468220</ProductCategoryId> <ProductCategoryName>Business & Finance</ProductCategoryName> <Parent> <ProductCategoryId>465600</ProductCategoryId> <ProductCategoryName>New, Used & Rental Textbooks</ProductCategoryName> <Parent> <ProductCategoryId>2349030011</ProductCategoryId> <ProductCategoryName>Specialty Boutique</ProductCategoryName> <Parent> <ProductCategoryId>283155</ProductCategoryId> <ProductCategoryName>Specialty Boutique</ProductCategoryName> </Parent> </Parent> </Parent> </Parent> </Self></GetProductCategoriesForSKUResult><ResponseMetadata> <RequestId>e058aabd-b4c3-48ba-9bfa-EXAMPLE9a267</RequestId></ResponseMetadata></GetProductCategoriesForSKUResponse>




GetProductCategoriesForASINReturns the parent product categories that a product belongs to, based on ASIN.

DescriptionThe GetProductCategoriesForASIN operation is the same as the GetProductCategoriesForSKU operation exceptthat it uses a MarketplaceId and an ASIN to uniquely identify a product.



MarketplaceId A marketplace identifier. Specifies the marketplace whosecategory structure should be returned.

Type: xs:string

Yes

ASIN Identifies the product in given the Marketplace.

Type: xs:string

Yes

Response elementsThe GetProductCategoriesForASIN operation returns the same response elements that are described in theGetProductCategoriesForSKU Response elements section.

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetProductCategoriesForASIN&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T22%3A51%3A51Z&Version=2011-10-01&Signature=%2BIEXAMPLE%2FvjuBYraHxZawj6F63rOVHx4PNEXAMPLEs%3D&SignatureMethod=HmacSHA256&MarketplaceId=ATVPDKIKX0DER&ASIN=B002KT3XQM

Example response

<?xml version="1.0"?><GetProductCategoriesForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"><GetProductCategoriesForASINResult> <Self>



<ProductCategoryId>2420095011</ProductCategoryId> <ProductCategoryName>Compression Shorts</ProductCategoryName> <Parent> <ProductCategoryId>2419332011</ProductCategoryId> <ProductCategoryName>Men</ProductCategoryName> <Parent> <ProductCategoryId>2371051011</ProductCategoryId> <ProductCategoryName>Clothing</ProductCategoryName> <Parent> <ProductCategoryId>3403201</ProductCategoryId> <ProductCategoryName>Bikes & Accessories</ProductCategoryName> <Parent> <ProductCategoryId>2232464011</ProductCategoryId> <ProductCategoryName>Bikes & Scooters</ProductCategoryName> <Parent> <ProductCategoryId>3375301</ProductCategoryId> <ProductCategoryName>Categories</ProductCategoryName> <Parent> <ProductCategoryId>3375251</ProductCategoryId> <ProductCategoryName>Categories</ProductCategoryName> </Parent> </Parent> </Parent> </Parent> </Parent> </Parent> </Self></GetProductCategoriesForASINResult><ResponseMetadata> <RequestId>fbce5b62-67cc-4ab8-86f3-EXAMPLE22e4e</RequestId></ResponseMetadata></GetProductCategoriesForASINResponse>




GetServiceStatusReturns the operational status of the Products API section.

DescriptionThe GetServiceStatus operation returns the operational status of the Products API section of Amazon MarketplaceWeb Service (Amazon MWS). Status values are GREEN, GREEN_I, YELLOW, and RED.

The GetServiceStatus operation has a maximum request quota of two requests and a restore rate of one requestevery five minutes. For definitions of throttling terminology, see Throttling.

Request parametersThe GetServiceStatus operation only accepts the required request parameters. For more information about therequest parameters that are required for all Amazon MWS operations, see "Required request parameters" in theAmazon MWS Developer Guide.

Response elementsName Description

Status The following list shows possible values returned by the GetServiceStatus operation:

GREEN The service is operating normally.

GREEN_I The service is operating normally. Additional information is provided.

YELLOW The service is experiencing higher than normal error rates or is operatingwith degraded performance. Additional information may be provided.

RED The service is unavailable or experiencing extremely high error rates.Additional information may be provided.

Type: xs:string

Timestamp Indicates the time at which the operational status was evaluated.

Type: xs:dateTime

MessageId An Amazon-defined message identifier.

Type: xs:string

Messages The parent element of one or more Message elements.

Message The operational status message.

The parent element of the following child elements (both child elements are type: xs:string):

• Locale• Text

Examples


https://mws.amazonservices.com/Products/2011-10-01?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ&Action=GetServiceStatus



&SellerId=A1IMEXAMPLEWRC&SignatureVersion=2&Timestamp=2012-12-04T22%3A53%3A58Z&Version=2011-10-01&Signature=7LYTEXAMPLE%2BrxcZsx%2BUjnYCvU9BeloQoQtEXAMPLEQ%3D&SignatureMethod=HmacSHA256

Example response

<?xml version="1.0"?><GetServiceStatusResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetServiceStatusResult> <Status>GREEN</Status> <Timestamp>2012-12-04T22:53:58.830Z</Timestamp> </GetServiceStatusResult> <ResponseMetadata> <RequestId>0a51dc17-20bf-4e0d-8ac5-5d53bd1129cf</RequestId> </ResponseMetadata></GetServiceStatusResponse>




QueryContextId ValuesThe following table contains QueryContextId values.

Marketplace QueryContextId values

CA (A2EUQ1WTGCTBG2) All

Books

Classical

DVD

Electronics

ForeignBooks

Kitchen

Music

Software

VHS

Video

VideoGames

CN (AAHKV2X7AFYLW) All

Apparel

Appliances

Automotive

Baby

Beauty

Books

Electronics

Grocery

HealthPersonalCare

Home

HomeImprovement

Jewelry

Misc

Music

OfficeProducts

Photo

Shoes

Software

SportingGoods

Toys

Video

VideoGames

Watches

DE (A1PA6795UKMFR9) All

Apparel

Automotive

Baby




Beauty

Books

Classical

DVD

Electronics

ForeignBooks

Grocery

HealthPersonalCare

HomeGarden

Jewelry

KindleStore

Kitchen

Lighting

Magazines

MP3Downloads

Music

MusicalInstruments

MusicTracks

OfficeProducts

OutdoorLiving

Outlet

PCHardware

Photo

Software

SportingGoods

Tools

Toys

VHS

Video

VideoGames

Watches

ES (A1RKKUPIHCS9HS) All

Books

DVD

Electronics

ForeignBooks

Kitchen

Music

Software

Toys

VideoGames

Watches

FR (A13V1IB3VIYZZH) All

Apparel

Baby




Beauty

Books

Classical

DVD

Electronics

ForeignBooks

HealthPersonalCare

Jewelry

Kitchen

Lighting

MP3Downloads

Music

MusicalInstruments

MusicTracks

OfficeProducts

Shoes

Software

VHS

Video

VideoGames

Watches

IT (APJ6JRA9NG5V4) All

Books

DVD

Electronics

ForeignBooks

Garden

Kitchen

Music

Shoes

Software

Toys

VideoGames

Watches

JP (A1VC38T7YXB528) All

Apparel

Automotive

Baby

Beauty

Books

Classical

DVD

Electronics

ForeignBooks

Grocery




HealthPersonalCare

Hobbies

HomeImprovement

Jewelry

Kitchen

MP3Downloads

Music

MusicalInstruments

MusicTracks

OfficeProducts

Shoes

Software

SportingGoods

Toys

VHS

Video

VideoGames

Watches

UK (A1F83G8C2ARO7P) All

Apparel

Automotive

Baby

Beauty

Books

Classical

DVD

Electronics

Grocery

HealthPersonalCare

HomeGarden

Jewelry

Kitchen

Lighting

MP3Downloads

Music

MusicalInstruments

MusicTracks

OfficeProducts

OutdoorLiving

Outlet

Shoes

Software

SoftwareVideoGames

Toys

VHS

Video




VideoGames

Watches

US (ATVPDKIKX0DER) All

Apparel

Appliances

ArtsAndCrafts

Automotive

Baby

Beauty

Books

Classical

DigitalMusic

DVD

Electronics

Grocery

HealthPersonalCare

HomeGarden

Industrial

Jewelry

KindleStore

Kitchen

Magazines

Miscellaneous

MobileApps

MP3Downloads

Music

MusicalInstruments

OfficeProducts

PCHardware

PetSupplies

Photo

Shoes

Software

SportingGoods

Tools

Toys

UnboxVideo

VHS

Video

VideoGames

Watches

Wireless

WirelessAccessories



Client library updates

The following tables describe the most recent updates to the Products API section client libraries:

PHP

Client libraryversion

Description

2013-11-01 Fixed bugs in the client library.

2013-08-01 The client libraries that are being released with this update are compatible with the previous release of the client libraries,but have been reorganized. Following are the major changes to the client libraries:

• The C# and Java client libraries now depend on a runtime library that is written in the same language. You can findthe source for the runtime library in the runtime-src directory, and the binary version is in the dist directory. The distdirectory also contains the binary versions of any third-party dependencies.

• The C# client library now includes compiled DLLs. Because you no longer need to compile the client library to use it,the Visual Studio solution and project files are not included in this release of the client library.

2013-02-01 Fixed an issue where an exception thrown during a call to Amazon MWS could contain incomplete information.

C#


Description

2013-11-01 Fixed bugs in the client library.

2013-10-01 Fixed some bugs in the previous version of the client library (2013-08-01). If you are using the previous version of theclient library, please upgrade to the most recent version.




Java


Description

2013-11-01 Fixed bugs in the PHP and C# client libraries. The Java client library is unchanged.




2012-10-11 Further strengthened the security and reliability of the client libraries.

Amazon Market Service Product API Reference manual

Documents

related topics