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 pricing information for the lowest-price active offer listings for up to 20 products, based on ASIN.
The GetLowestOfferListingsForASIN operation is the same as the GetLowestOfferListingsForSKU operation except that it uses a MarketplaceId and an ASIN to uniquely identify a product, and it does not return the SKUIdentifier element.
Instead of calling the GetLowestOfferListingsForASIN operation to obtain the lowest price offer listings for a specific product by item condition, consider calling the GetLowestPricedOffersForASIN operation.
You can also subscribe to the AnyOfferChanged notification by using the Subscriptions API service. When you subscribe to this notification, you will be notified whenever there is a price change or offer listing change for any of the top 20 offers, by condition (new or used), for an item that you sell.
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. |
ItemCondition | Filters the offer listings to be considered based on item condition. Type: xs:string |
No | ItemCondition values:
Default: All |
The GetLowestOfferListingsForASIN operation returns the Product response element that is described by the following publically available XSDs: ProductsAPI_Response.xsd and default.xsd. The GetLowestOfferListingsForASIN operation returns the following two sub-elements of the Products response element: Identifiers and LowestOfferListings.
Name | Description |
---|---|
AllOfferListingsConsidered | Indicates whether or not all of the active offer listings for the specified product and ItemCondition were considered when the listings were placed into their corresponding offer listing groups. When there are a large number of active offer listings for the specified product and ItemCondition, only a certain number of offer listings are considered. The listings that are considered always have lower landed prices than the landed prices of listings that are not considered. |
Product | Contains two of the sub-elements of the Product element from ProductsAPI_Response.xsd. These sub-elements are: Identifiers and LowestOfferListings. |
Identifiers | Contains the following identifiers that uniquely
identify a product:
|
LowestOfferListings | Contains pricing information for the lowest offer
listing for each offer listing group. Some 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=GetLowestOfferListingsForASIN &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A1IMEXAMPLEWRC &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-12-04T22%3A03%3A05Z &Version=2011-10-01 &Signature=fJFzEXAMPLEEax1vAdKP7l3lwKQUH1r34lcEXAMPLEA%3D
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetLowestOfferListingsForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestOfferListingsForASINResult ASIN="B002KT3XQM" status="Success"> <AllOfferListingsConsidered>true</AllOfferListingsConsidered> <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> <LowestOfferListings> <LowestOfferListing> <Qualifiers> <ItemCondition>Used</ItemCondition> <ItemSubcondition>VeryGood</ItemSubcondition> <FulfillmentChannel>Merchant</FulfillmentChannel> <ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>90-94%</SellerPositiveFeedbackRating> </Qualifiers> <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered> <SellerFeedbackCount>762</SellerFeedbackCount> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>28.00</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>4.99</Amount> </Shipping> </Price> <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice> </LowestOfferListing> <LowestOfferListing> <Qualifiers> <ItemCondition>New</ItemCondition> <ItemSubcondition>New</ItemSubcondition> <FulfillmentChannel>Amazon</FulfillmentChannel> <ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>98-100%</SellerPositiveFeedbackRating> </Qualifiers> <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered> <SellerFeedbackCount>181744</SellerFeedbackCount> <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> <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice> </LowestOfferListing> <LowestOfferListing> <Qualifiers> <ItemCondition>New</ItemCondition> <ItemSubcondition>New</ItemSubcondition> <FulfillmentChannel>Amazon</FulfillmentChannel> <ShipsDomestically>True</ShipsDomestically> <ShippingTime> <Max>0-2 days</Max> </ShippingTime> <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating> </Qualifiers> <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered> <SellerFeedbackCount>13213</SellerFeedbackCount> <Price> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>41.18</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>41.18</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </Price> <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice> </LowestOfferListing> </LowestOfferListings> </Product> </GetLowestOfferListingsForASINResult> <ResponseMetadata> <RequestId>60979901-82af-457b-8bdd-EXAMPLE28478</RequestId> </ResponseMetadata> </GetLowestOfferListingsForASINResponse>