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>