Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
Returns a list of products and their attributes, based on a list of ASIN values.
The GetMatchingProduct operation returns a list of products and their attributes, based on a list of ASIN values that you specify. This operation returns a maximum of ten products.
Important. All of the functionality of the GetMatchingProduct operation can be found in the new GetMatchingProductForId operation. The GetMatchingProduct operation is included in the Products API section for backward compatibility, but you should use the GetMatchingProductForId operation in favor of the GetMatchingProduct operation whenever possible. For more information, see GetMatchingProductForId.
This operation is available in all marketplaces.
Maximum request quota | Restore rate | Hourly request quota |
---|---|---|
20 requests | Two items every second | 7200 requests per hour |
For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.
Name | Description | Required | Valid values |
---|---|---|---|
MarketplaceId | A marketplace identifier. Specifies the marketplace from which products are
returned. Type: xs:string |
Yes | For a list of MarketplaceId values, see Amazon MWS endpoints and MarketplaceId values in the Amazon MWS Developer Guide. |
ASINList | A structured list of ASIN values. Used to identify
products in the given marketplace. Type: List of xs:string |
Yes | Maximum: 10 ASIN values |
The response elements that the GetMatchingProduct operation returns are described by the following publicly available XSDs:
The following table provides additional information about some of the key elements that are returned by the GetMatchingProduct operation.
Name | Description |
---|---|
Product | Contains four of the sub-elements of the Product element from ProductsAPI_Response.xsd. These sub-elements are: Identifiers, AttributeSets, Relationships, and SalesRankings. |
Identifiers | Contains the MarketplaceASIN combination that uniquely identifies a product. |
AttributeSets | Contains product attributes, from the
ItemAttributes element of default.xsd, if
they are applicable to the product that is returned. Note that a
Product response element will have multiple
attribute sets if it has attributes in more than one language. All
of the attributes, even ones that are not translated, are repeated
in each attribute set. The language used by each attribute set is
denoted by a lang attribute. Note: If a single
product has more than one image, then only the URL for the main
image is returned.
|
Relationships | Contains product variation information, if
applicable. If your search criteria match a product that is
identified by a variation parent ASIN, the related
VariationChild elements are contained in
the Relationships element. If your search
criteria match a specific variation child ASIN, the related
VariationParent element is contained in the
Relationships element. Note: Because this
operation does not return all product attributes, it is possible
to get VariationChild elements with
different ASIN values but the same
variation element values. These are distinct variation child
ASINs even though product attributes that differentiate them
from each other are not returned.
Variation attributes can be found in the VariationChild element of default.xsd. Note: Variation attributes are not included
in the VariationChild element if the input
ASIN values have more than 2000
combined VariationChild
elements.
|
SalesRankings | Sales rank information for the product by product
category. Sub-elements are:
|
For information about standard request requirements, see Required request parameters.
POST /Products/2011-10-01 HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> ASINList.ASIN.1=B002KT3XRQ &AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=GetMatchingProduct &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A1IMEXAMPLEWRC &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-12-04T21%3A01%3A53Z &Version=2011-10-01 &Signature=5O%2EXAMPLEtpSD0NbC%2FltDxXuLe2TXAd%2B48AEXAMPLE0%3D
For information about standard response formatting, see Response format.
<?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>