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

GetLowestOfferListingsForSKU

Returns pricing information for the lowest-price active offer listings for up to 20 products, based on SellerSKU.

Description

The GetLowestOfferListingsForSKU operation returns the lowest price offer listings for a specific product by item condition. The listings for the specified product and ItemCondition are placed in offer listing groups, each group representing a different combination of the following six qualifiers:

  • ItemCondition (New, Used, Collectible, Refurbished, or Club)
  • ItemSubcondition (New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other)
  • FulfillmentChannel (Amazon or Merchant)
  • ShipsDomestically (True, False, or Unknown) – Indicates whether the marketplace specified in the request and the location that the item ships from are in the same country.
  • ShippingTime (0-2 days, 3-7 days, 8-13 days, or 14 or more days) – Indicates the maximum time within which the item will likely be shipped once an order has been placed
  • SellerPositiveFeedbackRating (98-100%, 95-97%, 90-94%, 80-89%, 70-79%, Less than 70%, or Just launched ) – Indicates the percentage of feedback ratings that were positive over the past 12 months.

Some (but not necessarily all) of the active offer listings for the specified product and ItemCondition, initially sorted by the lowest landed price, are placed into their corresponding offer listing groups, and the listing with the lowest landed price from each group is returned. If multiple sellers have listings that share the lowest landed price for a group, the listing from the seller with the highest feedback count is returned. Groups without any listings are not returned.

This operation returns the AllOfferListingsConsidered response element, which 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. Note that even if not all the listings were considered, you can still expect the following:

  • The lowest landed prices that are returned will be the lowest landed prices from their respective offer listing groups.
  • The lowest landed prices that are returned will be lower than the landed prices for any listings that were not considered.
Note: When you submit the GetLowestOfferListingsForSKU operation, your own offer listings are included in the response unless you use the ExcludeMe request parameter with a value of True.
Note: Instead of calling the GetLowestOfferListingsForSKU operation to obtain the lowest price offer listings for a specific product by item condition, consider calling the GetLowestPricedOffersForSKU 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.

Availability

This operation is available in all marketplaces.

Throttling

Maximum request quota Restore rate Hourly request quota
20 requests 10 items every second 36000 requests per hour
This quota and restore rate is shared with GetLowestOfferListingsForASIN. 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.

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 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.
SellerSKUList A structured list of SellerSKU values. Used to identify products in the given marketplace. SellerSKU is qualified by your SellerId, which is included with every Amazon Marketplace Web Service (Amazon MWS) operation that you submit.

Type: List of xs:string

Yes Maximum: 20 SellerSKU values.
ItemCondition Filters the offer listings to be considered based on item condition.

Type: xs:string

No ItemCondition values:
  • Any
  • New
  • Used
  • Collectible
  • Refurbished
  • Club

Default: Any

Response elements

The GetLowestOfferListingsForSKU operation returns the Product response element that is described by the following publically available XSDs: ProductsAPI_Response.xsd and default.xsd. The GetLowestOfferListingsForSKU 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:
  • MarketplaceASINMarketplaceId and ASIN combination.
  • SKUIdentifierMarketplaceId, SellerSKU, and SellerId combination. Only returned if SellerSKU was specified in the request.
LowestOfferListings Contains pricing information for the lowest offer listing for each offer listing group.

Some key sub-elements are:

  • Qualifiers. Contains the following six qualifiers: ItemCondition, ItemSubcondition, FulfillmentChannel, ShipsDomestically, ShippingTime, and SellerPositiveFeedbackRating. These qualifiers identify the offer listing group from which the lowest offer listing was taken.
  • NumberOfOfferListingsConsidered. Of the offer listings considered, this number indicates how many belonged to this offer listing group. Note that if AllOfferListingsConsidered is returned with a value of True, then the value of NumberOfOfferListingsConsidered is the actual number of active offer listings that met the six qualifying criteria of the offer listing group. However if AllOfferListingsConsidered is returned with a value of False, then the actual number might be higher.
  • SellerFeedbackCount. The number of seller feedback ratings that have been submitted for the seller with the lowest-priced offer listing in the group.
  • Price. Pricing information for the lowest offer listing in the group. Contains the following elements:
    • ListingPrice. The listing price of the item.
    • Shipping. The shipping cost of the product. Note that the shipping cost is not always available.
    • LandedPrice. ListingPrice + Shipping - Points. Note that if the landed price is not returned, the listing price represents the product with the lowest landed price.
    • Points - The number of Amazon Points offered with the purchase of an item, and their monetary value. Note that the Points element is only returned in Japan (JP).
  • MultipleOfferListingsAtLowestPrice. Indicates if there is more than one listing with the lowest landed price in the group.

    Valid values:

    • True – There is more than one listing with the lowest listing price in the group.
    • False – There is only one listing with the lowest listing price in the group.
    • Unknown – The service cannot determine if there is more than one listing with the lowest listing price in the group. This can happen in certain cases when not all active offer listings were considered when the offer listings were sorted into groups (when AllOfferListingsConsidered = False).

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>

AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetLowestOfferListingsForSKU
&ExcludeMe=false
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SellerSKUList.SellerSKU.1=SKU2468
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T21%3A53%3A02Z
&Version=2011-10-01
&Signature=FUcIEXAMPLETUGtTS6sqNDt3OuLH8tbhz5YEXAMPLEw%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<GetLowestOfferListingsForSKUResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetLowestOfferListingsForSKUResult SellerSKU="SKU2468" status="Success">
        <AllOfferListingsConsidered>false</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>1933890517</ASIN>
                </MarketplaceASIN>
                <SKUIdentifier>
                    <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                    <SellerId>A1IMEXAMPLEWRC</SellerId>
                    <SellerSKU>SKU2468</SellerSKU>
                </SKUIdentifier>
            </Identifiers>
            <LowestOfferListings>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>Used</ItemCondition>
                        <ItemSubcondition>Acceptable</ItemSubcondition>
                        <FulfillmentChannel>Merchant</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>3</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>8900</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>28.68</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>24.69</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>3.99</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>True</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>Used</ItemCondition>
                        <ItemSubcondition>Good</ItemSubcondition>
                        <FulfillmentChannel>Amazon</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>90-94%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>1569694</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>30.50</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>30.50</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>0.00</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>Used</ItemCondition>
                        <ItemSubcondition>Good</ItemSubcondition>
                        <FulfillmentChannel>Merchant</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>3</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>7732</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>30.99</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>27.00</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>3.99</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
            </LowestOfferListings>
        </Product>
    </GetLowestOfferListingsForSKUResult>
    <ResponseMetadata>
        <RequestId>8106ed19-9a90-4820-881e-EXAMPLE0ab97</RequestId>
    </ResponseMetadata>
</GetLowestOfferListingsForSKUResponse>

↑ Top