Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation
Amazon MWS Documentation

GetLowestPricedOffersForSKU

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

Description

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.

Pricing Models

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.

Availability

This operation is available in all marketplaces except China.

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 GetLowestPricedOffersForASIN. 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 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.

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

Notes

  1. SellerSKU is qualified by your SellerId, which is included with every Amazon Marketplace Web Service (Amazon MWS) operation that you submit.
  2. If you specify a SellerSKU that identifies a variation parent ASIN, this operation returns the InvalidParamaterValue error. 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 GetLowestPricedOffersForSKU operation returns are described by the publicly available XSD ProductsAPI_Response.xsd. The top-level elements returned by the GetLowestPricedOffersForSKU operation are:

GetLowestPricedOffersForSKUResult Elements

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.

GetLowestPricedOffersForSKUResult Attributes

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

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 SKU.

Identifier Elements

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

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

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>

&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

↑ Top

Example response (Success)

For information about standard response formatting, see Response format.

Show example code Hide example code

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

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

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

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

↑ 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" 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>


↑ Top

Example response (Client 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" 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>

↑ Top