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 SellerSKU.
The GetCompetitivePricingForSKU operation returns the current competitive pricing of a product, based on the SellerSKU and MarketplaceId that you specify. Note that SellerSKU is qualified by your SellerId, which is included with every Amazon Marketplace Web Service (Amazon MWS) operation that you submit. This operation returns pricing for active offer listings based on two pricing models: New Buy Box Price and Used Buy Box Price. These pricing models are equivalent to the main Buy Box Price and the subordinate Buy Box Price, respectively, on a detail page from an Amazon marketplace website. Note that products with active offer listings might not return either of these prices. This could happen, for example, if none of the sellers with offer listings for a product are qualified for the New Buy Box or the Used Buy Box. Also note that your own price for the SellerSKU that you specify is not excluded from the response, so your price will be returned if it is the lowest listed price. The number of offer listings, the trade-in value, and the sales rankings for the SellerSKU that you specify are also returned.
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. |
SellerSKUList | A structured list of SellerSKU values.
Used to identify products in the given marketplace.
SellerSKU is qualified by your
SellerId, which is included with every
Amazon Marketplace Web Service (Amazon MWS) operation that you
submit. Type: List of xs:string |
Yes | Maximum: 20 SellerSKU values |
The response elements that the GetCompetitivePricingForSKU 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 GetCompetitivePricingForSKU 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> AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=GetCompetitivePricingForSKU &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A1IMEXAMPLEWRC &SellerSKUList.SellerSKU.1=SKU2468 &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-12-04T21%3A14%3A27Z &Version=2011-10-01 &Signature=wJI6EXAMPLE2Bfa46Ej%2BD1NwsIG%2Bjdyp828HHEXAMPLEY%3D
For information about standard response formatting, see Response format.
<?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>