Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント

Deprecation Notice:

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.

Amazon MWS ドキュメント

GetLowestPricedOffersForSKU

SellerSKUに応じた、単一の商品の最低価格の出品情報を返します。

説明

GetLowestPricedOffersForSKUオペレーションは、指定した特定のMarketplaceIdSellerSKUItemConditionの、上位20の商品を返します。上位20の商品は、配送料込みの価格(商品価格 + 配送料 - 獲得するAmazonポイント数)がどれだけ安いかによって決まります。複数の出品者が同じ配送料込み価格を設定している場合、結果は順不同で返されます。

価格モデル

このオペレーションは、「ショッピングカートボックスを獲得した新品の価格」と「ショッピングカートボックスを獲得した中古品の価格」の2種類の価格モデルに応じたアクティブな出品の価格設定を返します(中古品の価格は北米のみ)。これらの価格モデルは、AmazonマーケットプレイスWebサイトの商品詳細ページ上の、主要ショッピングカートボックス獲得価格とその下位の獲得価格にそれぞれ相当します。アクティブな出品のある商品が、このどちらの価格も返さない場合があります。たとえば、ある商品を出品しているすべての出品者が、新品または中古品のショッピングカートボックスを獲得する要件を満たしていない場合などです。指定したSellerSKUに対する出品者自身の価格もレスポンスに含まれるため、それが最低の出品価格である場合、出品者自身の価格が返されます。指定したSellerSKUに対する出品一覧数やtrade-in値(使用可能な場合)、売上ランキング情報も返されます。

利用可否

このオペレーションはすべてのマーケットプレイスで利用できます。ただし中国は除きます。

スロットリング

最大リクエストクォータ 回復レート 時間あたりのリクエストクォータ
10リクエスト 1秒ごとに5商品 1時間あたり200リクエスト
このクォータと回復レートはGetLowestPricedOffersForASINと共有されます。 スロットリング用語の定義およびスロットリングの詳しい説明については、Amazon MWS開発者ガイドスロットリング:リクエストの送信頻度を制限するを参照してください。商品ごとのスロットリングの詳細については、商品APIのスロットリングを参照してください。

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値:NewUsedCollectibleRefurbishedClub

タイプ:xs:string

注意

  1. SellerSKUは、出品者のSellerIdにより限定されます。SellerIdは、送信する各AmazonマーケットプレイスWebサービス(Amazon MWS)オペレーションに含まれます。
  2. バリエーションの親商品のSellerSKUを指定した場合、InvalidParamaterValueエラーが返されます。バリエーションの親商品は総称的な商品を表し、販売できません。バリエーションの子商品は商品の特性(サイズや色など)を表し、販売可能です。

レスポンス要素

GetLowestPricedOffersForSKUオペレーションが返すレスポンス要素は、一般に公開されているXSD ProductsAPI_Response.xsdで内容を確認できます。GetLowestPricedOffersForSKUオペレーションが返す最上位要素は以下の通りです。

GetLowestPricedOffersForSKUResult要素

名前 説明
Identifier マーケットプレイスおよびSKUで商品を識別します。
Summary LowestPricesBuyBoxPricesListPriceSuggestedLowerPricePlusShippingNumberOfOffersNumberOfBuyBoxEligibleOffers など、商品の価格情報が格納されます。
Offers Offer要素のリストで、PointsShippingTimeShippingShipsFromListingPriceSellerFeedbackRating などが出力されます。

GetLowestPricedOffersForSKUResult属性

Statusを除き、これらの属性はそれぞれ、呼び出しの元のリクエストパラメーターと一致します。Statusは、オペレーションの全体的な結果(SuccessまたはNoBuyableOffers)を示します。NoBuyableOffersは商品が出品されていないことを表します。

名前 説明 必須
MarketplaceId 暗号化された、Amazonが定義したマーケットプレイスID はい タイプ: MarketplaceType
SKU 問い合わせした商品 はい タイプ:xs:string
ItemCondition 商品のコンディション。 はい ItemCondition値:NewUsedCollectibleRefurbishedClub

タイプ:xs:string

Status オペレーションのステータス。 はい Status値:SuccessまたはNoBuyableOffers

タイプ:xs:string

Identifier

マーケットプレイスおよびSKUで商品を識別します。

Identifier要素

名前 説明 必須
MarketplaceId 暗号化された、Amazonが定義したマーケットプレイスID はい タイプ: MarketplaceType
SellerSKU 商品の出品者SKU。 はい タイプ:xs:string
ItemCondition 商品のコンディション。 はい ItemCondition値:NewUsedCollectibleRefurbishedClub

タイプ:xs:string

TimeOfOfferChange 出品の更新時刻。 いいえ ISO 8601日時フォーマット

タイプ:xs:dateTime

Summary

LowestPricesBuyBoxPricesListPriceSuggestedLowerPricePlusShippingNumberOfOffersNumberOfBuyBoxEligibleOffers など、商品の価格情報が格納されます。

Summary要素

名前 説明 必須
TotalOfferCount NumberOfOffersに含まれている一意な出品の数。 はい タイプ:xs:int
NumberOfOffers 商品の出品数の合計を示すリスト(コンディション・フルフィルメントチャネル別)。 はい タイプ: OfferCountType
LowestPrices 商品の最低価格の一覧。 いいえ タイプ:タイプのリスト: LowestPrice
BuyBoxPrices 商品価格の一覧。 いいえ タイプ:タイプのリスト: BuyBoxPrice
ListPrice メーカー希望価格。 いいえ タイプ: MoneyType
SuggestedLowerPricePlusShipping 商品の価格見直し例(商品価格 + 配送料 - 獲得するAmazonポイント数)。価格見直し例は販売価格の履歴、カートボックス価格および対象商品へのお客様のご意見などを基にしています。 いいえ タイプ: MoneyType
BuyBoxEligibleOffers ショッピングカートボックス獲得の対象となっている出品総数を示すリスト。(コンディション・フルフィルメントチャネル別) はい タイプ: OfferCountType

Offers

Offer要素のリストで、PointsShippingTimeShippingShipsFromListingPriceSellerFeedbackRating などが出力されます。

このリストの長さは、Summaryで示されるTotalOfferCountと同じ長さ、または20のいずれか小さい方です。

Offer要素

名前 説明 必須
MyOffer 出品者自身の出品の場合、true いいえ タイプ:xs:boolean
SubCondition 商品のサブコンディション。例:NewMintVery GoodGoodAcceptablePoorClubOEMWarrantyRefurbished WarrantyRefurbishedOpen 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>

↑ トップへ戻る