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 the current competitive price of a product, based on ASIN.
The GetCompetitivePricingForASIN operation is the same as the GetCompetitivePricingForSKU operation, except that it uses a MarketplaceId and an ASIN to uniquely identify a product, and it does not return the SKUIdentifier element. If you do not have the ASIN for a product, you will first have to submit the ListMatchingProducts operation for disambiguation.
This operation is available in all marketplaces.
Maximum request quota | Restore rate | Hourly request quota |
---|---|---|
20 requests | 10 items every second | 36000 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 prices 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: 20 ASIN values |
The response elements that the GetCompetitivePricingForASIN operation returns are described by the following publicly available XSD: ProductsAPI_Response.xsd. The following table provides additional information about some of the key elements that are returned by the GetCompetitivePricingForASIN operation.
Name | Description |
---|---|
Product | Contains three of the sub-elements of the Product element from ProductsAPI_Response.xsd. These sub-elements are: Identifiers, CompetitivePricing, and SalesRankings. |
Identifiers | Contains the following identifiers that uniquely
identify a product:
|
CompetitivePricing | Contains pricing information for the product that
is returned. Some key sub-elements are:
|
SalesRankings | Sales rank information for the product by product
category. Key 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=B002KT3XQM &AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=GetCompetitivePricingForASIN &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A1IMEXAMPLEWRC &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-12-04T21%3A23%3A31Z &Version=2011-10-01 &Signature=V1uTEXAMPLE8HVCfobAqQDKzylYyTRWfv3X4SEXAMPLEY%3D
For information about standard response formatting, see Response format.
<?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>