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

GetCompetitivePricingForASIN

ASINに応じた、商品の現在の競合価格を返します。

説明

GetCompetitivePricingForASINオペレーションは、商品を一意に識別するためにMarketplaceIdとASINを指定する点と、SKUIdentifier要素を返さない点を除き、GetCompetitivePricingForSKUオペレーションと同様です。商品のASINが不明な場合、それを明らかにするため、まず始めにListMatchingProductsオペレーションを送信する必要があります。

利用可否

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

スロットリング

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

リクエストパラメーター

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

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

タイプ：xs:string

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

タイプ：xsのリスト：string

 はい 最大：20個のASIN値

レスポンス要素

GetCompetitivePricingForASINオペレーションが返すレスポンス要素は、一般に公開されているXSD: ProductsAPI_Response.xsdで内容を確認できます。以下の表は、GetCompetitivePricingForASINオペレーションで返される主要な要素に関する追加情報です。

名前 説明
Product ProductsAPI_Response.xsdのProduct要素の3つのサブ要素を含む。サブ要素：Identifiers、CompetitivePricing、SalesRankings.。
Identifiers 商品を一意に識別する以下のIDを含む。
  • MarketplaceASIN – MarketplaceIdとASINの組み合わせ。
  • SKUIdentifier – MarketplaceId、SellerSKU、SellerIdの組み合わせ。リクエストにSellerSKUが指定されている場合のみ返されます。
CompetitivePricing 返される商品の価格情報を含む。

主なサブ要素：

  • CompetitivePrice。価格情報を含む。CompetitivePrice要素は、以下の属性を含む。
    • condition。価格情報を返す対象商品のコンディションを示す。可能な値：New、 Used、 Collectible、 Refurbished、 Club。
    • subcondition。価格情報を返す対象商品のサブコンディションを示す。可能な値：New、Mint、Very Good、Good、Acceptable、Poor、Club、OEM、Warranty、Refurbished Warranty、Refurbished、Open Box、 またはOther。
    • belongsToRequester。リクエストした出品者自身による出品の価格情報であるかどうかを示す。リクエストした出品者とは、リクエストとともに送信されたSellerIdに関連付けられた出品者です。可能な値：trueおよびfalse。
  • CompetitivePriceId。返される価格のそれぞれの価格モデル。有効値：1、2。値の定義：1 = 新品ショッピングカートボックス価格、2 = 中古品ショッピングカートボックス価格。
  • Price。指定したCompetitivePriceId値の価格情報。以下の要素を含む：
    • LandedPrice: ListingPrice + Shipping - Points。LandedPriceが返されない場合、ListingPriceがその商品の最低のLandedPriceを表します。
    • ListingPrice: 商品の出品価格。
    • Shipping: 商品の配送料。配送料が含まれない場合もあります。
    • Points: 商品の購入で獲得するAmazonポイント数と相当金額。Points要素が返されるのは日本(JP)の場合のみです。
  • NumberOfOfferListings。送信された商品のアクティブな出品の数。出品数は、OfferListingCountのサブ要素内の出品のコンディション別に返されます。可能なlisting condition値：Any、New、 Used、 Collectible、 Refurbished、 Club。
  • TradeInValue。Amazon Trade-Inプログラムの対象商品のtrade-in値。AmazonのTrade-Inプログラムの詳細については、マーケットプレイスごとのAmazonウェブサイトに掲載されたヘルプページの「Amazon Trade-Inプログラム」セクションを参照してください。（Amazon Trade-inプログラムは、日本では使用できません。）
SalesRankings 商品カテゴリー別の商品売上ランキング情報。

主なサブ要素：

  • ProductCategoryId。売上ランキングの対象の商品カテゴリーを指定する。
  • Rank。商品カテゴリー内の商品の売上ランク。

例

クエリリクエスト例

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

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

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=GetCompetitivePricingForASIN
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T21%3A23%3A31Z
&Version=2011-10-01
&Signature=V1uTEXAMPLE8HVCfobAqQDKzylYyTRWfv3X4SEXAMPLEY%3D

↑ トップへ戻る

レスポンス例

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

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

<?xml version="1.0"?>
<GetCompetitivePricingForASINResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetCompetitivePricingForASINResult ASIN="B002KT3XQM" status="Success">
        <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>
            <CompetitivePricing>
                <CompetitivePrices>
                    <CompetitivePrice belongsToRequester="false"
                        condition="New"
                        subcondition="New">
                        <CompetitivePriceId>1</CompetitivePriceId>
                        <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>
                    </CompetitivePrice>
                </CompetitivePrices>
                <NumberOfOfferListings>
                    <OfferListingCount condition="Any">11</OfferListingCount>
                    <OfferListingCount condition="Used">1</OfferListingCount>
                    <OfferListingCount condition="New">10</OfferListingCount>
                </NumberOfOfferListings>
            </CompetitivePricing>
            <SalesRankings/>
        </Product>
    </GetCompetitivePricingForASINResult>
    <ResponseMetadata>
        <RequestId>a8ec20c3-fc88-46e3-a128-EXAMPLE3fcdf</RequestId>
    </ResponseMetadata>
</GetCompetitivePricingForASINResponse>

↑ トップへ戻る