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 ASIN.
The GetMyPriceForASIN operation is the same as the GetMyPriceForSKU operation except that it uses a MarketplaceId and an ASIN to uniquely identify a product, and it does not return the SKUIdentifier element.
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 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. |
ASINList | A structured list of ASIN
values. Used to identify products in the given marketplace.
Type: List of xs:string |
Yes | Maximum: 20 ASIN 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 GetMyPriceForASIN 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 GetMyPriceForASIN 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> ASINList.ASIN.1=1933890517 &AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=GetMyPriceForASIN &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &SellerId=A1IMEXAMPLEWRC &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2012-12-04T22%3A40%3A47Z &Version=2011-10-01 &Signature=x%2FEXAMPLEFSPqX7tAN83%2FROsuHWc04SEaepLkEXAMPLEo%3D
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <GetMyPriceForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetMyPriceForASINResult ASIN="1933890517" 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> </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> </GetMyPriceForASINResult> <ResponseMetadata> <RequestId>a3381684-87bd-416e-9b95-EXAMPLE9c236</RequestId> </ResponseMetadata> </GetMyPriceForASINResponse>