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

GetCompetitivePricingForSKU

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

説明

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

注: バリエーションの親商品のSellerSKUを指定した場合、エラーが返されます。バリエーションの親商品は一般的な商品概要を表し、販売できません。バリエーションの子商品は商品の特性(サイズや色など)を表し、販売可能です。

利用可否

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

スロットリング

最大リクエストクォータ 回復レート 時間あたりのリクエストクォータ
20リクエスト 1秒ごとに10商品 1時間あたり36000リクエスト
このクォータと回復レートはGetCompetitivePricingForASINと共有されます。 スロットリング用語の定義およびスロットリングの詳しい説明については、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

レスポンス要素

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

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

主なサブ要素:

  • CompetitivePrice。価格情報を含む。CompetitivePrice要素は、以下の属性を含む。
    • condition。価格情報を返す対象商品のコンディションを示す。可能な値:NewUsedCollectibleRefurbishedClub
    • subcondition。価格情報を返す対象商品のサブコンディションを示す。可能な値:NewMintVery GoodGoodAcceptablePoorClubOEMWarrantyRefurbished WarrantyRefurbishedOpen Box、 またはOther
    • belongsToRequester。リクエストした出品者自身による出品の価格情報であるかどうかを示す。リクエストした出品者とは、リクエストとともに送信されたSellerIdに関連付けられた出品者です。可能な値:trueおよびfalse
  • CompetitivePriceId。返される価格のそれぞれの価格モデル。有効値:12。値の定義:1 = 新品ショッピングカートボックス価格、2 = 中古品ショッピングカートボックス価格。
  • Price。指定したCompetitivePriceId値の価格情報。以下の要素を含む:
    • LandedPrice: ListingPrice + Shipping - Points。LandedPriceが返されない場合、ListingPriceがその商品の最低のLandedPriceを表します。
    • ListingPrice: 商品の出品価格。
    • Shipping: 商品の配送料。配送料が含まれない場合もあります。
    • Points: 商品の購入で獲得するAmazonポイント数と相当金額。Points要素が返されるのは日本(JP)の場合のみです。
  • NumberOfOfferListings。送信された商品のアクティブな出品の数。出品数は、OfferListingCountのサブ要素内の出品のコンディション別に返されます。可能なlisting condition値:AnyNewUsedCollectibleRefurbishedClub
  • 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>

AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetCompetitivePricingForSKU
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=A1IMEXAMPLEWRC
&SellerSKUList.SellerSKU.1=SKU2468
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T21%3A14%3A27Z
&Version=2011-10-01
&Signature=wJI6EXAMPLE2Bfa46Ej%2BD1NwsIG%2Bjdyp828HHEXAMPLEY%3D

↑ トップへ戻る

レスポンス例

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

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

<?xml version="1.0"?>
<GetCompetitivePricingForSKUResponse
    xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
    <GetCompetitivePricingForSKUResult SellerSKU="SKU2468" 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>1933890517</ASIN>
                </MarketplaceASIN>
                <SKUIdentifier>
                    <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
                    <SellerId>A1IMEXAMPLEWRC</SellerId>
                    <SellerSKU>SKU2468</SellerSKU>
                </SKUIdentifier>
            </Identifiers>
            <CompetitivePricing>
                <CompetitivePrices>
                    <CompetitivePrice belongsToRequester="false"
                        condition="New"
                        subcondition="New">
                        <CompetitivePriceId>1</CompetitivePriceId>
                        <Price>
                            <LandedPrice>
                                <CurrencyCode>USD</CurrencyCode>
                                <Amount>40.03</Amount>
                            </LandedPrice>
                            <ListingPrice>
                                <CurrencyCode>USD</CurrencyCode>
                                <Amount>40.03</Amount>
                            </ListingPrice>
                            <Shipping>
                                <CurrencyCode>USD</CurrencyCode>
                                <Amount>0.00</Amount>
                            </Shipping>
                        </Price>
                    </CompetitivePrice>
                    <CompetitivePrice belongsToRequester="false"
                        condition="Used"
                        subcondition="Good">
                        <CompetitivePriceId>2</CompetitivePriceId>
                        <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>
                    </CompetitivePrice>
                </CompetitivePrices>
                <NumberOfOfferListings>
                    <OfferListingCount condition="Any">296</OfferListingCount>
                    <OfferListingCount condition="Used">145</OfferListingCount>
                    <OfferListingCount condition="New">151</OfferListingCount>
                </NumberOfOfferListings>
                <TradeInValue>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>17.05</Amount>
                </TradeInValue>
            </CompetitivePricing>
            <SalesRankings>
                <SalesRank>
                    <ProductCategoryId>book_display_on_website</ProductCategoryId>
                    <Rank>900</Rank>
                </SalesRank>
                <SalesRank>
                    <ProductCategoryId>271578011</ProductCategoryId>
                    <Rank>1</Rank>
                </SalesRank>
                <SalesRank>
                    <ProductCategoryId>355562011</ProductCategoryId>
                    <Rank>8</Rank>
                </SalesRank>
                <SalesRank>
                    <ProductCategoryId>173516</ProductCategoryId>
                    <Rank>25</Rank>
                </SalesRank>
            </SalesRankings>
        </Product>
    </GetCompetitivePricingForSKUResult>
    <ResponseMetadata>
        <RequestId>003fc73e-bf70-4e55-8db8-EXAMPLEce417</RequestId>
    </ResponseMetadata>
</GetCompetitivePricingForSKUResponse>

↑ トップへ戻る