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.
SellerSKUに応じた、単一の商品の最低価格の出品情報を返します。
GetLowestPricedOffersForSKUオペレーションは、指定した特定のMarketplaceId、SellerSKU、ItemConditionの、上位20の商品を返します。上位20の商品は、配送料込みの価格(商品価格 + 配送料 - 獲得するAmazonポイント数)がどれだけ安いかによって決まります。複数の出品者が同じ配送料込み価格を設定している場合、結果は順不同で返されます。
このオペレーションは、「ショッピングカートボックスを獲得した新品の価格」と「ショッピングカートボックスを獲得した中古品の価格」の2種類の価格モデルに応じたアクティブな出品の価格設定を返します(中古品の価格は北米のみ)。これらの価格モデルは、AmazonマーケットプレイスWebサイトの商品詳細ページ上の、主要ショッピングカートボックス獲得価格とその下位の獲得価格にそれぞれ相当します。アクティブな出品のある商品が、このどちらの価格も返さない場合があります。たとえば、ある商品を出品しているすべての出品者が、新品または中古品のショッピングカートボックスを獲得する要件を満たしていない場合などです。指定したSellerSKUに対する出品者自身の価格もレスポンスに含まれるため、それが最低の出品価格である場合、出品者自身の価格が返されます。指定したSellerSKUに対する出品一覧数やtrade-in値(使用可能な場合)、売上ランキング情報も返されます。
このオペレーションはすべてのマーケットプレイスで利用できます。ただし中国は除きます。
最大リクエストクォータ | 回復レート | 時間あたりのリクエストクォータ |
---|---|---|
10リクエスト | 1秒ごとに5商品 | 1時間あたり200リクエスト |
1時間に問い合わせできるSKUまたはASINは200件までのため、GetLowestPricedOffersForSKUを呼び出して出品者自身が出品しているSKUの上位20の出品を取得したあとは、CreateSubscriptionを呼び出してAnyOfferChanged通知をサブスクライブしてください。出品者自身が販売しているSKUの上位20の出品に変更があった場合に通知されるため、GetLowestPricedOffersForSKUクォータを使う必要がありません。
すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイドの必須のリクエストパラメーターを参照してください。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
MarketplaceID | マーケットプレイスID。価格を取得するマーケットプレイスを指定する。 | はい | MarketplaceId値の一覧については、Amazon MWS開発者ガイドのAmazon MWSエンドポイントとMarketplaceId値を参照してください。 タイプ:xs:string |
SellerSKU | 問い合わせする商品を識別するSellerSKU。 | はい | タイプ:xs:string |
ItemCondition | 商品コンディションに応じて結果をフィルタします。 | はい | ItemCondition値:New、 Used、 Collectible、 Refurbished、 Club。 タイプ:xs:string |
GetLowestPricedOffersForSKUオペレーションが返すレスポンス要素は、一般に公開されているXSD ProductsAPI_Response.xsdで内容を確認できます。GetLowestPricedOffersForSKUオペレーションが返す最上位要素は以下の通りです。
名前 | 説明 |
---|---|
Identifier | マーケットプレイスおよびSKUで商品を識別します。 |
Summary | LowestPrices、 BuyBoxPrices、 ListPrice、 SuggestedLowerPricePlusShipping、 NumberOfOffers、 NumberOfBuyBoxEligibleOffers など、商品の価格情報が格納されます。 |
Offers | Offer要素のリストで、Points、 ShippingTime、 Shipping、 ShipsFrom、 ListingPrice、 SellerFeedbackRating などが出力されます。 |
Statusを除き、これらの属性はそれぞれ、呼び出しの元のリクエストパラメーターと一致します。Statusは、オペレーションの全体的な結果(SuccessまたはNoBuyableOffers)を示します。NoBuyableOffersは商品が出品されていないことを表します。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
MarketplaceId | 暗号化された、Amazonが定義したマーケットプレイスID | はい | タイプ: MarketplaceType |
SKU | 問い合わせした商品 | はい | タイプ:xs:string |
ItemCondition | 商品のコンディション。 | はい | ItemCondition値:New、 Used、 Collectible、 Refurbished、 Club。 タイプ:xs:string |
Status | オペレーションのステータス。 | はい | Status値:SuccessまたはNoBuyableOffers。 タイプ:xs:string |
マーケットプレイスおよびSKUで商品を識別します。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
MarketplaceId | 暗号化された、Amazonが定義したマーケットプレイスID | はい | タイプ: MarketplaceType |
SellerSKU | 商品の出品者SKU。 | はい | タイプ: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のいずれか小さい方です。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
MyOffer | 出品者自身の出品の場合、true。 | いいえ | タイプ:xs:boolean |
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> &SellerSKU=24478624 &AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ &Action= GetLowestPricedOffersForSKU &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"?> <GetLowestPricedOffersForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForSKUResult MarketplaceID="ATVPDKIKX0DER" SKU="GE Product" ItemCondition="New" status="Success"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <SellerSKU>GE Product</SellerSKU> <ItemCondition>New</ItemCondition> <TimeOfOfferChange>2015-07-19T23:15:11.859Z</TimeOfOfferChange> </Identifier> <Summary> <TotalOfferCount>1</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> <MyOffer>false</MyOffer> <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> </GetLowestPricedOffersForSKUResult> <ResponseMetadata> <RequestId>fd2e6c6d-0b6d-499b-9fea-074175c0547a</RequestId> </ResponseMetadata> </GetLowestPricedOffersForSKUResponse>
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?> <GetLowestPricedOffersForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <GetLowestPricedOffersForSKUResult MarketplaceID="ATVPDKIKX0DER" SKU="0I-RIAS-6UA0" ItemCondition="new" status="NoBuyableOffers"> <Identifier> <MarketplaceId>ATVPDKIKX0DER</MarketplaceId> <SellerSKU>0I-RIAS-6UA0</SellerSKU> <ItemCondition>New</ItemCondition> </Identifier> <Summary> <TotalOfferCount>0</TotalOfferCount> </Summary> <Offers/> </GetLowestPricedOffersForSKUResult> <ResponseMetadata> <RequestId>75621aa7-9c8b-40be-9bf9-3ac1efdcdb87</RequestId> </ResponseMetadata> </GetLowestPricedOffersForSKUResponse>
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?xml version="1.0"?> <ErrorResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"> <Error MarketplaceID="ATVPDKIKX0DER" SKU="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" SKU="asdgv" ItemCondition="new" status="ClientError"> <Code>InvalidParameterValue</Code> <Type>Sender</Type> <Message>asdgv is an invalid SKU for marketplace ATVPDKIKX0DER</Message> </Error> <ResponseMetadata> <RequestId>1714394f-07a3-4bc4-8072-53abf8c3759a</RequestId> </ResponseMetadata> </ErrorResponse>