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.
SellerSKUに応じた、商品の現在の競合価格を返します。
GetCompetitivePricingForSKUオペレーションは、指定したSellerSKUおよびMarketplaceIdに応じた、商品の現在の競合価格を返します。SellerSKUは、出品者のSellerIdにより限定されます。SellerIdは、送信する各AmazonマーケットプレイスWebサービス(Amazon MWS)オペレーションに含まれます。このオペレーションは、「ショッピングカートボックスを獲得した新品の価格」と「ショッピングカートボックスを獲得した中古品の価格」の2種類の価格モデルに応じたアクティブな出品一覧を返します。これらの価格モデルは、AmazonマーケットプレイスWebサイトの商品詳細ページ上の、主要ショッピングカートボックス獲得価格とその下位の獲得価格にそれぞれ相当します。アクティブな出品一覧の商品が、このどちらの価格も返さない場合があります。たとえば、ある商品を出品しているすべての出品者が、新品または中古品のショッピングカートボックスを獲得する要件を満たしていない場合などです。また、指定したSellerSKUに対する出品者自身の価格もレスポンスに含まれるため、それが最低の出品価格である場合、出品者自身の価格が返されます。指定したSellerSKUに対する出品一覧数やtrade-in値(使用可能な場合)、売上ランキング情報も返されます。
このオペレーションはすべてのマーケットプレイスで利用できます。
最大リクエストクォータ | 回復レート | 時間あたりのリクエストクォータ |
---|---|---|
20リクエスト | 1秒ごとに10商品 | 1時間あたり36000リクエスト |
すべての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つのサブ要素を含む。サブ要素:Identifiers、CompetitivePricing、SalesRankings.。 |
Identifiers | 商品を一意に識別する以下のIDを含む。
|
CompetitivePricing | 返される商品の価格情報を含む。 主なサブ要素:
|
SalesRankings | 商品カテゴリー別の商品売上ランキング情報。 主なサブ要素:
|
標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。
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>