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 ドキュメント

GetLowestOfferListingsForSKU

SellerSKUに応じた、最低価格のアクティブな出品の価格情報を最大20個まで返します。

説明

GetLowestOfferListingsForSKUオペレーションは、指定した商品の最低価格の出品一覧(コンディション別)を返します。指定した商品およびItemConditionの一覧は、以下の6つの条件の組み合わせで定義される、出品一覧グループに分類されます。

  • ItemCondition (New、 Used、 Collectible、 Refurbished、 Club)
  • ItemSubcondition (New、Mint、Very Good、Good、Acceptable、Poor、Club、OEM、Warranty、Refurbished Warranty、Refurbished、Open Box、 またはOther)
  • FulfillmentChannel (AmazonまたはMerchant)
  • ShipsDomestically (True、False、またはUnknown) – リクエストに指定されているマーケットプレイスと、商品の発送元国が同じかどうかを示す。
  • ShippingTime (0-2 days、3-7 days、8-13 days、または14 or more days) – 注文されてから商品が出荷されるまでの通常の最長準備期間を表す。
  • SellerPositiveFeedbackRating (98-100%、95-97%、90-94%、80-89%、70-79%、Less than 70%、またはJust launched) – 過去12か月以上の良い評価の割合を%で表す。

指定した商品およびItemConditionに対する一部の(必ずしも全部ではない)アクティブな出品一覧は、まず配送料を含む最低価格でソートされ、対応する出品一覧グループに分類され、グループごとの最低価格を返します。グループ内に最低価格で出品している出品者が複数いる場合は、フィードバック数が最も多い出品者の出品一覧が返されます。出品一覧が存在しないグループは返されません。

このオペレーションは、レスポンス要素AllOfferListingsConsideredを返します。この要素は、指定した商品およびItemConditionに応じたアクティブな出品一覧のすべてが、対応する出品一覧グループに分類される際に考慮されたかどうかを示します。もしすべてが考慮されなかった場合でも、以下の結果が期待できます。

  • 返された最低価格は、対応する出品一覧グループにおける最低配送料込み価格である。
  • 返された最低価格は、考慮されなかったすべての出品の最低配送料込み価格より低い。
注: GetLowestOfferListingsForSKUオペレーションを送信した場合、ExcludeMeリクエストパラメーターをTrueの値で使用しない限り、出品者の出品商品もレスポンスに含まれます。
注: 指定した商品の最低価格の出品(コンディション別)を取得するには、GetLowestOfferListingsForSKUオペレーションの代わりにGetLowestPricedOffersForSKUオペレーションを呼び出してみてください。

また、サブスクリプションAPIセクションを使ってAnyOfferChanged通知をサブスクライブします。この通知をサブスクライブすると、出品している商品について、コンディション(新品または中古品)別の上位20の出品に価格変更または出品情報の変更があるたびに通知が送信されます。

利用可否

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

スロットル

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

リクエストパラメーター

すべてのAmazon MWSオペレーションに必須とされるリクエストパラメータについて詳しくは、Amazon MWS開発者ガイドの必須のリクエストパラメーターを参照してください。

名前 説明 必須 推奨値
MarketplaceId マーケットプレイスID。価格を取得するマーケットプレイスを指定する。

タイプ：xs:string

 はい MarketplaceId値の一覧については、Amazon MWS開発者ガイドのAmazon MWSエンドポイントとMarketplaceId値を参照してください。
SellerSKUList SellerSKU値の構造化リスト。指定したマーケットプレイスにある商品を識別するために使用。SellerSKUは出品者のSellerIdにより限定されます。SellerIdは、送信する各AmazonマーケットプレイスWebサービス(Amazon MWS)オペレーションに含まれます。

タイプ：xsのリスト：string

 はい 最大：20個のSellerSKU値。
ItemCondition 商品コンディションにより出品一覧をフィルターする。

タイプ：xs:string

 いいえ ItemCondition値：
  • Any
  • New
  • Used
  • Collectible
  • Refurbished
  • Club

デフォルト：Any

レスポンス要素

GetLowestOfferListingsForSKUオペレーションは、Productレスポンス要素を返します。Productレスポンス要素については、一般に公開されているXSD、ProductsAPI_Response.xsdおよびdefault.xsdで内容を確認できます。GetLowestOfferListingsForSKUオペレーションは、Productsレスポンス要素の2つのサブ要素、IdentifiersおよびLowestOfferListingsを返します。

名前 説明
AllOfferListingsConsidered 指定した商品およびItemConditionに応じたアクティブな出品のすべてが、対応する出品グループに分類される際に対象となったかどうかを示す。指定した商品およびItemConditionに応じたアクティブな出品商品の件数が多い場合は、一定数の出品のみ対象となります一定数の出品のみ対象となります。対象の出品の配送料込み価格は、常に対象外の出品の配送料込み価格よりも安い価格になります。
Product ProductsAPI_Response.xsdのProduct要素の2つのサブ要素を含む。サブ要素：IdentifiersおよびLowestOfferListingsを返します。
Identifiers 商品を一意に識別する以下のIDを含む。
  • MarketplaceASIN – MarketplaceIdとASINの組み合わせ。
  • SKUIdentifier – MarketplaceId、 SellerSKU、 SellerIdの組み合わせ。リクエストにSellerSKUが指定されている場合のみ返されます。
LowestOfferListings 出品商品グループごとの、最も安い出品の価格情報を含む。

主なサブ要素：

  • Qualifiers。以下の6つの条件を含む：ItemCondition、 ItemSubcondition、 FulfillmentChannel、 ShipsDomestically、 ShippingTime、 SellerPositiveFeedbackRating。 6つの条件では、最低価格の出品商品が含まれる出品商品グループを指定します。
  • NumberOfOfferListingsConsidered。対象の出品のうち、その出品グループに含まれた出品件数を示す。 AllOfferListingsConsideredで返された値がTrueの場合、NumberOfOfferListingsConsidered値 は出品グループの6つの条件に一致したアクティブな出品の実際の数を表します。 ただし、AllOfferListingsConsideredで返された値がFalseの場合、実際の数はこれより大きくなる可能性があります。
  • SellerFeedbackCount。グループ内において最低価格で出品している出品者に対して送信されたフィードバック数。
  • Price。グループ内で最低価格の出品の価格情報。以下の要素を含む：
    • LandedPrice: ListingPrice + Shipping - Points。LandedPriceが返されない場合、ListingPriceがその商品の最低のLandedPriceを表します。
    • ListingPrice: 商品の出品価格。
    • Shipping: 商品の配送料。配送料が含まれない場合もあります。
    • Points: 商品の購入で獲得するAmazonポイント数と相当金額。Points要素が返されるのは日本(JP)の場合のみです。
  • MultipleOfferListingsAtLowestPrice。LandedPriceの値に基づいて最低価格の出品がグループ内に複数あるかどうかを示す。

    有効値：

    • True: グループ内で最低価格の出品が複数ある。
    • False: グループ内で最低価格の出品が1つしかない。
    • Unknown: グループ内で最低価格の出品が複数あるかどうかを判断できない。出品商品をグループでソートしたときにアクティブな出品商品の一部しか対象にされない場合(AllOfferListingsConsidered =Falseの場合)、確定しないことがあります。

例

クエリリクエスト例

標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。

サンプルを表示するサンプルを隠す

POST /Products/2011-10-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetLowestOfferListingsForSKU
&ExcludeMe=false
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SellerSKUList.SellerSKU.1=SKU2468
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T21%3A53%3A02Z
&Version=2011-10-01
&Signature=FUcIEXAMPLETUGtTS6sqNDt3OuLH8tbhz5YEXAMPLEw%3D

↑ トップへ戻る

レスポンス例

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

サンプルを表示するサンプルを隠す

<?xml version="1.0"?>
<GetLowestOfferListingsForSKUResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetLowestOfferListingsForSKUResult SellerSKU="SKU2468" status="Success">
        <AllOfferListingsConsidered>false</AllOfferListingsConsidered>
        <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>
                <SKUIdentifier>
                    <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                    <SellerId>A1IMEXAMPLEWRC</SellerId>
                    <SellerSKU>SKU2468</SellerSKU>
                </SKUIdentifier>
            </Identifiers>
            <LowestOfferListings>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>Used</ItemCondition>
                        <ItemSubcondition>Acceptable</ItemSubcondition>
                        <FulfillmentChannel>Merchant</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>3</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>8900</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>28.68</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>24.69</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>3.99</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>True</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>Used</ItemCondition>
                        <ItemSubcondition>Good</ItemSubcondition>
                        <FulfillmentChannel>Amazon</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>90-94%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>1569694</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>30.50</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>30.50</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>0.00</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>Used</ItemCondition>
                        <ItemSubcondition>Good</ItemSubcondition>
                        <FulfillmentChannel>Merchant</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>3</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>7732</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>30.99</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>27.00</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>3.99</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
            </LowestOfferListings>
        </Product>
    </GetLowestOfferListingsForSKUResult>
    <ResponseMetadata>
        <RequestId>8106ed19-9a90-4820-881e-EXAMPLE0ab97</RequestId>
    </ResponseMetadata>
</GetLowestOfferListingsForSKUResponse>

↑ トップへ戻る