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

GetLowestOfferListingsForASIN

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

説明

GetLowestOfferListingsForASINオペレーションは、商品を一意に識別するためにMarketplaceIdとASINを指定する点と、SKUIdentifier要素を返さない点を除き、GetLowestOfferListingsForSKUオペレーションと同様です。

注:

指定した商品の最低価格の出品一覧(コンディション別)を取得するには、GetLowestOfferListingsForASINオペレーションの代わりにGetLowestPricedOffersForASINオペレーションを呼び出すことをご検討ください。

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

利用可否

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

スロットリング

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

リクエストパラメーター

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

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

タイプ：xs:string

 はい MarketplaceId値の一覧については、Amazon MWS開発者ガイドのAmazon MWSエンドポイントとMarketplaceId値を参照してください。
ASINList ASIN値の構造化リスト。指定したマーケットプレイスにある商品を識別するために使用。

タイプ：xsのリスト：string

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

タイプ：xs:string

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

デフォルト：All

レスポンス要素

GetLowestOfferListingsForASINオペレーションは、Productレスポンス要素を返します。Productレスポンス要素については、一般に公開されているXSD、ProductsAPI_Response.xsdおよびdefault.xsdで内容を確認できます。GetLowestOfferListingsForASINオペレーションは、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>

ASINList.ASIN.1=B002KT3XQM
&AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetLowestOfferListingsForASIN
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T22%3A03%3A05Z
&Version=2011-10-01
&Signature=fJFzEXAMPLEEax1vAdKP7l3lwKQUH1r34lcEXAMPLEA%3D

↑ トップへ戻る

レスポンス例

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

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

<?xml version="1.0"?>
<GetLowestOfferListingsForASINResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetLowestOfferListingsForASINResult ASIN="B002KT3XQM" status="Success">
        <AllOfferListingsConsidered>true</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>B002KT3XQM</ASIN>
                </MarketplaceASIN>
            </Identifiers>
            <LowestOfferListings>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>Used</ItemCondition>
                        <ItemSubcondition>VeryGood</ItemSubcondition>
                        <FulfillmentChannel>Merchant</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>90-94%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>762</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>32.99</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>28.00</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>4.99</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>New</ItemCondition>
                        <ItemSubcondition>New</ItemSubcondition>
                        <FulfillmentChannel>Amazon</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>98-100%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>181744</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>34.27</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>34.27</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>0.00</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
                <LowestOfferListing>
                    <Qualifiers>
                        <ItemCondition>New</ItemCondition>
                        <ItemSubcondition>New</ItemSubcondition>
                        <FulfillmentChannel>Amazon</FulfillmentChannel>
                        <ShipsDomestically>True</ShipsDomestically>
                        <ShippingTime>
                            <Max>0-2 days</Max>
                        </ShippingTime>
                        <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating>
                    </Qualifiers>
                    <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered>
                    <SellerFeedbackCount>13213</SellerFeedbackCount>
                    <Price>
                        <LandedPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>41.18</Amount>
                        </LandedPrice>
                        <ListingPrice>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>41.18</Amount>
                        </ListingPrice>
                        <Shipping>
                            <CurrencyCode>USD</CurrencyCode>
                            <Amount>0.00</Amount>
                        </Shipping>
                    </Price>
                    <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
                </LowestOfferListing>
            </LowestOfferListings>
        </Product>
    </GetLowestOfferListingsForASINResult>
    <ResponseMetadata>
        <RequestId>60979901-82af-457b-8bdd-EXAMPLE28478</RequestId>
    </ResponseMetadata>
</GetLowestOfferListingsForASINResponse>

↑ トップへ戻る