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.
ASINに応じた、単一の商品の最低価格の出品情報を返します。
GetLowestPricedOffersForASINオペレーションは、商品を一意に識別するためにMarketplaceIdとASINを指定する点と、MyOffer要素を返さない点を除き、GetLowestPricedOffersForSKUオペレーションと同様です。商品のASINが不明な場合は、ListMatchingProductsオペレーションを使ってASINを検索できます。
このオペレーションはすべてのマーケットプレイスで利用できます。ただし中国は除きます。
最大リクエストクォータ | 回復レート | 時間あたりのリクエストクォータ |
---|---|---|
10リクエスト | 1秒ごとに5商品 | 1時間あたり200リクエスト |
1時間に問い合わせできるSKUまたはASINは200件までのため、GetLowestPricedOffersForASINを呼び出して出品者自身が出品しているASINの上位20の出品を取得したあとは、CreateSubscriptionを呼び出してAnyOfferChanged通知をサブスクライブしてください。出品者自身が販売しているASINの上位20の出品に変更があった場合に通知されるため、GetLowestPricedOffersForASINクォータを使う必要がありません。
すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイドの必須のリクエストパラメーターを参照してください。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
MarketplaceId | 暗号化された、Amazonが定義したマーケットプレイスID | はい | タイプ: MarketplaceType |
ASIN | 商品のAmazon標準識別番号(ASIN)。 | はい | タイプ:xs:string |
ItemCondition | 商品コンディションに応じて結果をフィルタします。 | はい | ItemCondition値:New、 Used、 Collectible、 Refurbished、 Club。 タイプ:xs:string |
GetLowestPricedOffersForASINオペレーションが返すレスポンス要素は、一般に公開されているXSD ProductsAPI_Response.xsdで内容を確認できます。GetLowestPricedOffersForASINオペレーションが返す最上位要素は以下の通りです。
名前 | 説明 |
---|---|
Identifier | マーケットプレイスおよびASINで商品を識別します。 |
Summary | LowestPrices、 BuyBoxPrices、 ListPrice、 SuggestedLowerPricePlusShipping、 NumberOfOffers、 NumberOfBuyBoxEligibleOffers など、商品の価格情報が格納されます。 |
Offers | Offer要素のリストで、Points、 ShippingTime、 Shipping、 ShipsFrom、 ListingPrice、 SellerFeedbackRating などが出力されます。 |
Statusを除き、これらの属性はそれぞれ、呼び出しの元のリクエストパラメーターと一致します。Statusはオペレーションの全体的な結果(SuccessまたはNoBuyableOffers)を示します。NoBuyableOffersは商品が出品されていないことを表します。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
MarketplaceId | 暗号化された、Amazonが定義したマーケットプレイスID | はい | タイプ: MarketplaceType |
ASIN | 商品のAmazon標準識別番号(ASIN)。 | はい | タイプ:xs:string |
ItemCondition | 商品のコンディション。 | はい | ItemCondition値:New、 Used、 Collectible、 Refurbished、 Club。 タイプ:xs:string |
Status | オペレーションのステータス。 | はい | Status値:SuccessまたはNoBuyableOffers。 タイプ:xs:string |
マーケットプレイスおよびASINで商品を識別します。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
MarketplaceId | 暗号化された、Amazonが定義したマーケットプレイスID | はい | タイプ: MarketplaceType |
ASIN | 商品のAmazon標準識別番号(ASIN)。 | はい | タイプ:xs:string |
ItemCondition | 商品のコンディション。 | はい | ItemCondition値:New、 Used、 Collectible、 Refurbished、 Club。 タイプ:xs:string |
TimeOfOfferChange | 出品の更新時刻。 | いいえ | ISO 8601日時フォーマット。 タイプ:xs:dateTime |
LowestPrices、 BuyBoxPrices、 ListPrice、 SuggestedLowerPricePlusShipping、 NumberOfOffers、 NumberOfBuyBoxEligibleOffers など、商品の価格情報が格納されます。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
TotalOfferCount | NumberOfOffersに含まれている一意な出品の数。 | はい | タイプ:xs:int |
NumberOfOffers | 商品の出品数の合計を示すリスト(コンディション・フルフィルメントチャネル別)。 | はい | タイプ: OfferCountType |
LowestPrices | 商品の最低価格の一覧。 | いいえ | タイプ:タイプのリスト: LowestPrice |
BuyBoxPrices | 商品価格の一覧。 | いいえ | タイプ:タイプのリスト: BuyBoxPrice |
ListPrice | メーカー希望価格。 | いいえ | タイプ: MoneyType |
SuggestedLowerPricePlusShipping | 商品の価格見直し例(商品価格 + 配送料 - 獲得するAmazonポイント数)。価格見直し例は販売価格の履歴、カートボックス価格および対象商品へのお客様のご意見などを基にしています。 | いいえ | タイプ: MoneyType |
BuyBoxEligibleOffers | ショッピングカートボックス獲得の対象となっている出品総数を示すリスト。(コンディション・フルフィルメントチャネル別) | はい | タイプ: OfferCountType |
Offer要素のリストで、Points、 ShippingTime、 Shipping、 ShipsFrom、 ListingPrice、 SellerFeedbackRating などが出力されます。
このリストの長さは、Summaryで示されるTotalOfferCountと同じ長さ、または20のいずれか小さい方です。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
Subcondition | 商品のサブコンディション。 | はい | Subcondition値:New、Mint、Very
Good、Good、Acceptable、Poor、Club、OEM、Warranty、Refurbished
Warranty、Refurbished、Open Box、
またはOther。 タイプ:xs:string |
SellerFeedbackRating | 出品者のフィードバックに関する情報(良い評価を受けた割合および寄せられたフィードバックの総数)。 | いいえ | タイプ: SellerFeedbackRating |
ShippingTime | 注文から商品が出荷できるようになるまでの最大時間。 | はい | タイプ: DetailedShippingTimeType |
ListingPrice | 商品の価格。 | はい | タイプ: MoneyType |
Points | 商品の購入で獲得するAmazonポイント数。 | いいえ | タイプ: Points |
Shipping | 配送料。 | はい | タイプ: MoneyType |
ShipsFrom | 商品の発送元の都道府県および国。 | いいえ | タイプ: ShipsFrom |
IsFulfilledByAmazon | Amazonから出荷で出品する場合は true。 | はい | タイプ:xs:boolean |
IsBuyBoxWinner | true (現在ショッピングカートボックスにある場合)。いつでも、1つのASINあたり最大2件(プライム対象とプライム対象外それぞれ1つ)のショッピングカートボックス獲得出品者が存在します。 | いいえ | タイプ:xs:boolean |
IsFeaturedMerchant | true (商品の出品者にショッピングカートボックスを獲得する資格がある場合)。 | いいえ | タイプ:xs:boolean |
標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。
POST /Products/2011-10-01 HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> &ASIN=B00COK3FD8 &AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action=GetLowestPricedOffersForASIN &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceId=ATVPDKIKX0DER &ItemCondition=New &SellerId=A1IMEXAMPLEWRC &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2015-05-22T21%3A23%3A31Z &Version=2011-10-01 &Signature=V1uTEXAMPLE8HVCfobAqQDKzylYyTRWfv3X4SEXAMPLEY%3D
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?><GetLowestPricedOffersForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForASINResult MarketplaceID="ATVPDKIKX0DER" ItemCondition="New" ASIN="B0002GTTRC" status="Success"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B0002GTTRC</ASIN> <ItemCondition>New</ItemCondition> <TimeOfOfferChange>2015-07-19T23:15:11.859Z</TimeOfOfferChange> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> <NumberOfOffers> <OfferCount condition="new" fulfillmentChannel="Amazon">1</OfferCount> </NumberOfOffers> <LowestPrices> <LowestPrice condition="new" fulfillmentChannel="Amazon"> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </LowestPrice> </LowestPrices> <BuyBoxPrices> <BuyBoxPrice condition="New"> <LandedPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </LandedPrice> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> </BuyBoxPrice> </BuyBoxPrices> <ListPrice> <CurrencyCode>USD</CurrencyCode> <Amount>58.34</Amount> </ListPrice> <SuggestedLowerPricePlusShipping> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </SuggestedLowerPricePlusShipping> <BuyBoxEligibleOffers> <OfferCount condition="new" fulfillmentChannel="Amazon">1</OfferCount> </BuyBoxEligibleOffers> </Summary> <Offers> <Offer> <SubCondition>new</SubCondition> <SellerFeedbackRating> <SellerPositiveFeedbackRating>100.0</SellerPositiveFeedbackRating> <FeedbackCount>1</FeedbackCount> </SellerFeedbackRating> <ShippingTime minimumHours="0" maximumHours="0" availabilityType="NOW"/> <ListingPrice> <CurrencyCode>USD</CurrencyCode> <Amount>32.99</Amount> </ListingPrice> <Shipping> <CurrencyCode>USD</CurrencyCode> <Amount>0.00</Amount> </Shipping> <IsFulfilledByAmazon>true</IsFulfilledByAmazon> <IsBuyBoxWinner>true</IsBuyBoxWinner> <IsFeaturedMerchant>true</IsFeaturedMerchant> </Offer> </Offers> </GetLowestPricedOffersForASINResult> <ResponseMetadata> <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId> </ResponseMetadata> </GetLowestPricedOffersForASINResponse>
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?> <GetLowestPricedOffersForASINResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForASINResult MarketplaceID="ATVPDKIKX0DER" ItemCondition="New" ASIN="B000EVPGSQ" status="NoBuyableOffers"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <ASIN>B000EVPGSQ</ASIN> <ItemCondition>New</ItemCondition> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> </Summary> <Offers/> </GetLowestPricedOffersForASINResult> <ResponseMetadata> <RequestId>2bb867cd-8fa3-406c-adba-eb84c1796d21</RequestId> </ResponseMetadata> </GetLowestPricedOffersForASINResponse>
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?> <ErrorResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <Error MarketplaceID="ATVPDKIKX0DER" ASIN="24478624" ItemCondition="New" status="ServerError"> <Type>Receiver</Type> <Message>Server Error. Try back later</Message> <Detail/> </Error> <ResponseMetadata> <RequestId>88faca76-b600-46d2-b53c-0c8c4533e43a</RequestId> </ResponseMetadata> </ErrorResponse>
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?> <ErrorResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <Error MarketplaceID="ATVPDKIKX0DER" ASIN="B0002GTTRD" ItemCondition="New" status="ClientError"> <Code>InvalidParameterValue</Code> <Type>Sender</Type> <Message>B0002GTTRD is an invalid ASIN for marketplace ATVPDKIKX0DER</Message> </Error> <ResponseMetadata> <RequestId>3e8e64e8-edd7-4b63-a855-fa44094951ff</RequestId> </ResponseMetadata> </ErrorResponse>