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 lowest priced offers for a single product, based on SellerSKU.
The GetLowestPricedOffersForSKU operation returns the top 20 offers for a given MarketplaceId, SellerSKU, and ItemCondition that you specify. The top 20 offers are determined by the lowest landed price, which is the price plus shipping minus Amazon Points. If multiple sellers are charging the same landed price, the results will be returned in random order.
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. 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. Your own price for the SellerSKU that you specify is not excluded from the response, so your price will be returned if it is among the lowest listed prices. 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 |
---|---|---|
10 requests | Five items every second | 200 requests per hour |
Because you can only query 200 SKUs or ASINs per hour, after you call GetLowestPricedOffersForSKU to get the top 20 offers for a SKU you sell, you should call CreateSubscription and subscribe to an AnyOfferChanged notification. That will inform you if the top 20 offers change for any SKU you sell without using any of your GetLowestPricedOffersForSKU quota.
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 | Values |
---|---|---|---|
MarketplaceID | A marketplace identifier. Specifies the marketplace from which prices are returned. | Yes |
For a list of MarketplaceId values,
see Amazon MWS endpoints and MarketplaceId values in the Amazon MWS Developer Guide.
Type: xs:string |
SellerSKU | The SellerSKU that identifies the product to query. | Yes | Type: xs:string |
ItemCondition | Filters the results based on item condition. | Yes | ItemCondition
values: New, Used,
Collectible,
Refurbished, Club.
Type: xs:string |
The response elements that the GetLowestPricedOffersForSKU operation returns are described by the publicly available XSD ProductsAPI_Response.xsd. The top-level elements returned by the GetLowestPricedOffersForSKU operation are:
Name | Description |
---|---|
Identifier | Identifies a product by marketplace and SKU. |
Summary | Contains price information about the product, including the LowestPrices and BuyBoxPrices, the ListPrice, the SuggestedLowerPricePlusShipping, and NumberOfOffers and NumberOfBuyBoxEligibleOffers. |
Offers | A list of Offer elements, including Points, ShippingTime, Shipping, ShipsFrom, ListingPrice, SellerFeedbackRating, and more. |
Name | Description | Required | Values |
---|---|---|---|
MarketplaceId | An encrypted, Amazon-defined marketplace identifier. | Yes | Type: MarketplaceType |
SKU | The product queried. | Yes | Type: xs:string |
ItemCondition | The item condition. | Yes | ItemCondition
values: New, Used,
Collectible,
Refurbished, Club.
Type: xs:string |
Status | The status of the operation. | Yes | Status values:
Success,
ActiveButTooSoonForProcessing,
NoBuyableOffers, or
NoOfferDueToMissingShippingCharge. Type: xs:string |
Identifies a product by marketplace and SKU.
Name | Description | Required | Values |
---|---|---|---|
MarketplaceId | An encrypted, Amazon-defined marketplace identifier. | Yes | Type: MarketplaceType |
SellerSKU | The Seller SKU of the item. | Yes | Type: xs:string |
ItemCondition | The item condition. | Yes | ItemCondition
values: New, Used,
Collectible,
Refurbished, Club.
Type: xs:string |
TimeOfOfferChange | The update time for the offer. | No | In ISO 8601 date time format. Type: xs:dateTime |
Contains price information about the product, including the LowestPrices and BuyBoxPrices, the ListPrice, the SuggestedLowerPricePlusShipping, and NumberOfOffers and NumberOfBuyBoxEligibleOffers.
Name | Description | Required | Values |
---|---|---|---|
TotalOfferCount | The number of unique offers contained in NumberOfOffers. | Yes | Type: xs:int |
NumberOfOffers | A list that contains the total number of offers for the item for the given conditions and fulfillment channels. | Yes | Type: OfferCountType |
LowestPrices | A list of the lowest prices for the item. | No | Type: List of LowestPrice |
BuyBoxPrices | A list of item prices. | No | Type: List of BuyBoxPrice |
ListPrice | The list price of the item as suggested by the manufacturer. | No | Type: MoneyType |
SuggestedLowerPricePlusShipping | The suggested lower price of the item, including shipping and Amazon Points. The suggested lower price is based on a range of factors, including historical selling prices, recent Buy Box-eligible prices, and input from customers for your products. | No | Type: MoneyType |
SalesRankings | A list that contains the sales rank of the item in the given product categories. | No | Type: List of SalesRank |
BuyBoxEligibleOffers | A list that contains the total number of offers that are eligible for the Buy Box for the given conditions and fulfillment channels. | No | Type: OfferCountType |
CompetitivePriceThreshold | This price is based on competitive prices from other retailers (excluding
other Amazon sellers). The offer may be ineligible for the Buy Box if the
seller's price + shipping (minus Amazon Points) is greater than this competitive
price. Note: In Japan, CompetitivePriceThreshold considers
any points that a non-Amazon retailer applies to their selling
price.
|
No | Type: MoneyType |
OffersAvailableTime | When the status is ActiveButTooSoonForProcessing, this is the time when the offers will be available for processing. | No | Type: xs:dateTime |
A list of Offer elements, including Points, ShippingTime, Shipping, ShipsFrom, ListingPrice, SellerFeedbackRating, and more.
This list is the same length as the TotalOfferCount provided in the Summary or 20, whichever is less.
Name | Description | Required | Values |
---|---|---|---|
SellerId | The seller identifier for the offer. | Yes | Type: xs:string |
MyOffer | true if this is your offer. | No | Type: xs:boolean |
SubCondition | The subcondition of the item. For example: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other. | Yes | Type: xs:string |
SellerFeedbackRating | Information about the seller's feedback, including the percentage of positive feedback, and the total count of feedback received. | No | Type: SellerFeedbackRating |
ShippingTime | The maximum time within which the item will likely be shipped once an order has been placed. | Yes | Type: DetailedShippingTimeType |
ListingPrice | The price of the item. | Yes | Type: MoneyType |
Points | The number of Amazon Points offered with the purchase of an item. | No | Type: Points |
Shipping | The shipping cost. | Yes | Type: MoneyType |
ShipsFrom | The state and country from where the item is shipped. | No | Type: ShipsFrom |
IsFulfilledByAmazon | true if the offer is fulfilled by Amazon. | Yes | Type: xs:boolean |
IsBuyBoxWinner | true if the offer is currently in the Buy Box. There can be up to two Buy Box winners at any time per ASIN, one that is eligible for Prime and one that is not eligible for Prime. | No | Type: xs:boolean |
IsFeaturedMerchant | true if the seller of the item is eligible to win the Buy Box. | No | Type: xs:boolean |
ConditionNotes | Information about the condition of the item. | No | Type: xs:string |
PrimeInformation | Amazon Prime information. | No | Type: PrimeInformation |
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> &SellerSKU=24478624 &AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action= GetLowestPricedOffersForSKU &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &ItemCondition=New &SellerId=A1IMEXAMPLEWRC &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2015-05-22T21%3A23%3A31Z &Version=2011-10-01 &Signature=V1uTEXAMPLE8HVCfobAqQDKzylYyTRWfv3X4SEXAMPLEY%3D
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetLowestPricedOffersForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForSKUResult MarketplaceID="ATVPDKIKX0DER" SKU="GE Product" ItemCondition="New" status="Success"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <SellerSKU>GE Product</SellerSKU> <ItemCondition>New</ItemCondition> <TimeOfOfferChange>2015-07-19T23:15:11.859Z</TimeOfOfferChange> </Identifier> <Summary> <TotalOfferCount>1</TotalOfferCount> <NumberOfOffers> <OfferCount condition="new" fulfillmentChannel="Amazon">1</OfferCount> </NumberOfOffers> <LowestPrices> <LowestPrice condition="new" fulfillmentChannel="Amazon"> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </LowestPrice> </LowestPrices> <BuyBoxPrices> <BuyBoxPrice condition="New"> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </BuyBoxPrice> </BuyBoxPrices> <ListPrice> <CurrencyCode>USD</CurrencyCode> <Amount>58.34</Amount> </ListPrice> <SuggestedLowerPricePlusShipping> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </SuggestedLowerPricePlusShipping> <BuyBoxEligibleOffers> <OfferCount condition="new" fulfillmentChannel="Amazon">1</OfferCount> </BuyBoxEligibleOffers> </Summary> <Offers> <Offer> <MyOffer>false</MyOffer> <SubCondition>new</SubCondition> <SellerFeedbackRating> <SellerPositiveFeedbackRating>100.0</SellerPositiveFeedbackRating> <FeedbackCount>1</FeedbackCount> </SellerFeedbackRating> <ShippingTime minimumHours="0" maximumHours="0" availabilityType="NOW"/> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> <IsFulfilledByAmazon>true</IsFulfilledByAmazon> <IsBuyBoxWinner>true</IsBuyBoxWinner> <IsFeaturedMerchant>true</IsFeaturedMerchant> </Offer> </Offers> </GetLowestPricedOffersForSKUResult> <ResponseMetadata> <RequestId>fd2e6c6d-0b6d-499b-9fea-074175c0547a</RequestId> </ResponseMetadata> </GetLowestPricedOffersForSKUResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetLowestPricedOffersForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForSKUResult MarketplaceID="ATVPDKIKX0DER" SKU="0I-RIAS-6UA0" ItemCondition="new" status="NoBuyableOffers"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <SellerSKU>0I-RIAS-6UA0</SellerSKU> <ItemCondition>New</ItemCondition> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> </Summary> <Offers/> </GetLowestPricedOffersForSKUResult> <ResponseMetadata> <RequestId>75621aa7-9c8b-40be-9bf9-3ac1efdcdb87</RequestId> </ResponseMetadata> </GetLowestPricedOffersForSKUResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0" encoding="UTF-8"?> <GetLowestPricedOffersForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForSKUResult MarketplaceID="ATVPDKIKX0DER" SKU="0I-RIAS-6UA0" ItemCondition="new" status="NoOfferDueToMissingShippingCharge"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <SellerSKU>0I-RIAS-6UA0</SellerSKU> <ItemCondition>New</ItemCondition> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> </Summary> <Offers/> </GetLowestPricedOffersForSKUResult> <ResponseMetadata> <RequestId>75621aa7-9c8b-40be-9bf9-3ac1efdcdb87</RequestId> </ResponseMetadata> </GetLowestPricedOffersForSKUResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetLowestPricedOffersForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForSKUResult MarketplaceID="A2EUQ1WTGCTBG2" SKU="ACA-8039-6PK-DL57" ItemCondition="New" status="ActiveButTooSoonForProcessing"> <Identifier> <MarketplaceId>A2EUQ1WTGCTBG2</MarketplaceId> <SellerSKU>ACA-8039-6PK-DL57</SellerSKU> <ItemCondition>New</ItemCondition> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> <OffersAvailableTime>2017-03-08T07:13:21.763Z</OffersAvailableTime> </Summary> <Offers/> </GetLowestPricedOffersForSKUResult> <ResponseMetadata> <RequestId>1212334</RequestId> </ResponseMetadata> </GetLowestPricedOffersForSKUResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ErrorResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <Error MarketplaceID="ATVPDKIKX0DER" SKU="24478624" ItemCondition="New" status="ServerError"> <Type>Receiver</Type> <Message>Server Error. Try back later</Message> <Detail/> </Error> <ResponseMetadata> <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId> </ResponseMetadata> </ErrorResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ErrorResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <Error MarketplaceID="ATVPDKIKX0DER" SKU="asdgv" ItemCondition="new" status="ClientError"> <Code>InvalidParameterValue</Code> <Type>Sender</Type> <Message>asdgv is an invalid SKU for marketplace ATVPDKIKX0DER</Message> </Error> <ResponseMetadata> <RequestId>1714394f-07a3-4bc4-8072-53abf8c3759a</RequestId> </ResponseMetadata> </ErrorResponse>