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 ASIN.
The GetLowestPricedOffersForASIN operation is the same as the GetLowestPricedOffersForSKU operation, except that it uses a MarketplaceId and an ASIN to uniquely identify a product, and it does not return the MyOffer element. If you do not have the ASIN for a product, you can use the ListMatchingProducts operation to search for the ASIN.
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 GetLowestPricedOffersForASIN to get the top 20 offers for an ASIN you sell, you should call CreateSubscription and subscribe to an AnyOfferChanged notification. That will inform you if the top 20 offers change for any ASIN you sell without using any of your GetLowestPricedOffersForASIN 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 | An encrypted, Amazon-defined marketplace identifier. | Yes | Type: MarketplaceType |
ASIN | The Amazon Standard Identification Number (ASIN) of the item. | 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 GetLowestPricedOffersForASIN operation returns are described by the publicly available XSD ProductsAPI_Response.xsd. The top-level elements returned by the GetLowestPricedOffersForASIN operation are:
Name | Description |
---|---|
Identifier | Identifies a product by marketplace and ASIN. |
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 |
ASIN | The Amazon Standard Identification Number (ASIN) of the item. | 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 ASIN.
Name | Description | Required | Values |
---|---|---|---|
MarketplaceId | An encrypted, Amazon-defined marketplace identifier. | Yes | Type: MarketplaceType |
ASIN | The Amazon Standard Identification Number (ASIN) 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 |
Subcondition | The subcondition of the item. | Yes | Subcondition values: New, Mint,
Very Good, Good,
Acceptable, Poor, Club,
OEM, Warranty, Refurbished
Warranty, Refurbished, Open Box,
or Other. 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> &ASIN=B00COK3FD8 &AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=GetLowestPricedOffersForASIN &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"?><GetLowestPricedOffersForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForASINResult MarketplaceID="ATVPDKIKX0DER" ItemCondition="New" ASIN="B0002GTTRC" status="Success"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B0002GTTRC</ASIN> <ItemCondition>New</ItemCondition> <TimeOfOfferChange>2015-07-19T23:15:11.859Z</TimeOfOfferChange> </Identifier> <Summary> <TotalOfferCount>0</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> <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> </GetLowestPricedOffersForASINResult> <ResponseMetadata> <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId> </ResponseMetadata> </GetLowestPricedOffersForASINResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetLowestPricedOffersForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForASINResult MarketplaceID="ATVPDKIKX0DER" ItemCondition="New" ASIN="B000EVPGSQ" status="NoBuyableOffers"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B000EVPGSQ</ASIN> <ItemCondition>New</ItemCondition> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> </Summary> <Offers/> </GetLowestPricedOffersForASINResult> <ResponseMetadata> <RequestId>2bb867cd-8fa3-406c-adba-eb84c1796d21</RequestId> </ResponseMetadata> </GetLowestPricedOffersForASINResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0" encoding="UTF-8"?> <GetLowestPricedOffersForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForASINResult MarketplaceID="ATVPDKIKX0DER" ItemCondition="New" ASIN="B000EVPGSQ" status="NoOfferDueToMissingShippingCharge"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B000EVPGSQ</ASIN> <ItemCondition>New</ItemCondition> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> </Summary> <Offers/> </GetLowestPricedOffersForASINResult> <ResponseMetadata> <RequestId>2bb867cd-8fa3-406c-adba-eb84c1796d21</RequestId> </ResponseMetadata> </GetLowestPricedOffersForASINResponse>
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetLowestPricedOffersForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForASINResult MarketplaceID="ATVPDKIKX0DER" ItemCondition="New" ASIN="B01DL3WCPI" status="ActiveButTooSoonForProcessing"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B01DL3WCPI</ASIN> <ItemCondition>New</ItemCondition> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> <OffersAvailableTime>2017-03-08T06:21:05.330Z</OffersAvailableTime> </Summary> <Offers/> </GetLowestPricedOffersForASINResult> <ResponseMetadata> <RequestId>1212334</RequestId> </ResponseMetadata> </GetLowestPricedOffersForASINResponse>
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" ASIN="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" ASIN="B0002GTTRD" ItemCondition="New" status="ClientError"> <Code>InvalidParameterValue</Code> <Type>Sender</Type> <Message>B0002GTTRD is an invalid ASIN for marketplace ATVPDKIKX0DER</Message> </Error> <ResponseMetadata> <RequestId>3e8e64e8-edd7-4b63-a855-fa44094951ff</RequestId> </ResponseMetadata> </ErrorResponse>