Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

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.

Amazon MWS Documentation

GetLowestPricedOffersForASIN

Returns lowest priced offers for a single product, based on ASIN.

Description

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.

Availability

This operation is available in all marketplaces.

Throttling

Maximum request quota Restore rate Hourly request quota
10 requests Five items every second 200 requests per hour
This quota and restore rate is shared with GetLowestPricedOffersForSKU. Operations in the Products API section that send lists of items as input parameters have restore rates that are measured by item. For information on per-item throttling, see Throttling in the Products API. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

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.

Request parameters

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

Notes

  1. If you specify an ASIN that identifies a variation parent ASIN, this operation returns NoBuyableOffers. A variation parent ASIN represents a generic product that cannot be sold. Variation child ASINs represent products that have specific characteristics (such as size and color) and can be sold.

Response elements

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:

GetLowestPricedOffersForASINResult Elements

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.

GetLowestPricedOffersForASINResult Attributes

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

Except for Status, each of these attributes match the original request parameters for the call. Status represents the overall result of the operation with one of the following values:
  • Success
  • ActiveButTooSoonForProcessing - the item is active but no offers can be displayed until OffersAvailableTime
  • NoBuyableOffers - the item is not being offered for sale
  • NoOfferDueToMissingShippingCharge - the shipping charge is absent (for example, when the shipping charge varies by region)

Identifier

Identifies a product by marketplace and ASIN.

Identifier Elements

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

Summary

Contains price information about the product, including the LowestPrices and BuyBoxPrices, the ListPrice, the SuggestedLowerPricePlusShipping, and NumberOfOffers and NumberOfBuyBoxEligibleOffers.

Summary Elements

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

Offers

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.

Offer Element

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

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

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

↑ Top

Example response (Success)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top

Example response (Success with no offers)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top

Example response (Missing shipping charge)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top

Example response (Active but too soon for processing)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top

Example response (Server error)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>


↑ Top

Example response (Invalid ASIN)

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top