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 your own active offer listings, based on SellerSKU.
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.
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 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:
Default: All |
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:
|
BuyingPrice | Contains pricing information that includes
promotions and contains the shipping cost. Contains the following elements:
|
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:
|
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. |
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> 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
For information about standard response formatting, see Response format.
<?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>