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

GetMyPriceForSKU

Returns pricing information for your own active offer listings, based on SellerSKU.

Description

The GetMyPriceForSKU operation returns pricing information for your own active offer listings, based on the ASIN mapped to the SellerSKU and MarketplaceId that you specify. Note that if you submit a SellerSKU for a product for which you don’t have an active offer listing, the operation returns an empty Offers element. This operation returns pricing information for a maximum of 20 offer listings.

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 GetMyPriceForASIN. 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 offer listings 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:
  • New
  • Used
  • Collectible
  • Refurbished
  • Club

Default: All

Response elements

The response elements that the GetMyPriceForSKU operation returns are described by the following publicly available XSD: ProductsAPI_Response.xsd. The following table provides additional information about some of the key elements that are returned by the GetMyPriceForSKU operation.

Name Description
Identifiers Contains the following identifiers that uniquely identify a product:
  • MarketplaceASIN. MarketplaceId and ASIN combination.
  • SKUIdentifier. MarketplaceId, SellerSKU, and SellerId combination. Only returned if SellerSKU was specified in the request.
BuyingPrice Contains pricing information that includes promotions and contains the shipping cost.

Contains the following elements:

  • ListingPrice. The current price including any promotions that apply to the product.
  • Shipping. The shipping cost of the product.
  • 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).
RegularPrice The current price excluding any promotions that apply to the product. Excludes the shipping cost.
FulfillmentChannel The fulfillment channel for the offer listing.

Valid values:

  • Amazon - Fulfilled by Amazon.
  • Merchant - Fulfilled by the seller.
ItemCondition The item condition for the offer listing. Valid values: New, Used, Collectible, Refurbished, or Club.
ItemSubCondition The item subcondition for the offer listing. Valid values: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other.
SellerId The SellerId submitted with the operation.
SellerSKU The SellerSKU for the offer listing.

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=GetMyPriceForSKU
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SellerSKUList.SellerSKU.1=SKU2468
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T22%3A08%3A04Z
&Version=2011-10-01
&Signature=%2B0EXAMPLEuiHJv7xLyYVBgLQa17eJtmP4MIEXAMPLE0%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<GetMyPriceForSKUResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetMyPriceForSKUResult SellerSKU="SKU2468" status="Success">
        <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>
            <Offers>
                <Offer>
                    <BuyingPrice>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>303.99</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>300.00</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>3.99</Amount>
                        </Shipping>
                    </BuyingPrice>
                    <RegularPrice>
                        <CurrencyCode>USD</CurrencyCode>
                        <Amount>300.00</Amount>
                    </RegularPrice>
                    <FulfillmentChannel>MERCHANT</FulfillmentChannel>
                    <ItemCondition>Used</ItemCondition>
                    <ItemSubCondition>Acceptable</ItemSubCondition>
                    <SellerId>A1IMEXAMPLEWRC</SellerId>
                    <SellerSKU>SKU2468</SellerSKU>
                </Offer>
            </Offers>
        </Product>
    </GetMyPriceForSKUResult>
    <ResponseMetadata>
        <RequestId>bc6e4601-3d74-4612-adcf-EXAMPLEf1796</RequestId>
    </ResponseMetadata>
</GetMyPriceForSKUResponse>

↑ Top