Keepa APIのリクエストの1つ、「Request Best Sellers」の公式レファレンスを日本語訳しました。
Amazonのランキング上位の商品を抽出するAPIです。
大カテゴリで500,000件のASINが取得できます。
(サブカテゴリだと5,000件)
ただ、ASINしか分からないので、販売価格などを知りたい場合は追加でRequest ProductsといったAPIと組み合わせる必要があります。
売れているか商品を一覧化できるので、競合商品分析や仕入れ判断に利用できそうです。
それでは、↓から日本語訳スタートです！
- 「参考」で囲った部分は筆者の補足です。
- 適宜サブタイトルの追加や、意訳を実施しています。
- Keepaから翻訳の許可を頂いております。
こちら↓↓↓の記事に全てのKeepa APIに関する日本語訳記事をまとめているので、他のレファレンスも確認したい場合はご参考ください！
リクエストの基本情報
消費トークン
50トークン
特定のカテゴリーまたは商品グループの売上に基づいて、最も人気のある商品の ASIN リストを取得します。
※注意 : 販売順位参考カテゴリーを正しく特定できない場合があり、商品がズレている場合があります。
- ルートカテゴリーリスト (「ホーム & キッチン」など) または商品グループ リストには、最大 500,000 個の ASIN が含まれます。
利用可能なすべてのルート カテゴリのリストについては、Category Lookup※でcategoryId=0 を指定してください。 - サブカテゴリーリスト (「ホームエンターテインメント家具」など) には、最大 5,000 の ASIN が含まれます。
サブカテゴリのリストは、商品の主要な販売ランクに基づいて作成されたものであり、Amazon での実際の注文を反映するものではありません。 - リストは通常、1 時間ごとに更新されます。
- リストは、ベストセラー製品から順に並べられています。
注: リストは最大 1 時間キャッシュされるため、順序が古くなっている可能性があります。 - 売れ筋ランキングにない商品は対象外となります。
これは、衣料品およびスポーツ & アウトドア カテゴリの多くの製品に特に影響します。
Category LookupはAmazonのカテゴリー構造(カテゴリー名&カテゴリーID)を取得するKeepaのAPIです。
詳しくは下記記事で説明しています。
リクエストのQueryパラメータ
/bestsellers?key=<yourAccessKey>&domain=<domainId>&category=<categoryId>&range=<range>- <yourAccessKey>
APIキー - <domainId>
アクセスする Amazon ロケールの整数値。
有効な値:
[ 1: com | 2: co.uk | 3: de | 4: fr | 5: co.jp | 6: ca | 8: it | 9: es | 10: in | 11: com.mx ] - <categoryId>
ベストセラー リストをリクエストするカテゴリのカテゴリ ノード ID。
カテゴリ ノード ID は、category search request※、deals (カテゴリを検索/選択して [API クエリを表示] をクリック)、または Amazon で見つけることができます。
または、商品オブジェクトの productGroup フィールドにある商品グループ (「Beauty」など) を指定することもできます。 - <range>
オプションで、現在の販売ランクではなく、販売ランクの平均に基づいてベストセラー リストを取得するように指定できます。
有効な値:
[ 0: 現在のランクを使用 | 30: 30 日平均 | 90: 90 日間の平均 | 180: 180 日平均 ]
Category SearchはAmazonのカテゴリー構造(カテゴリー名&カテゴリーID)を、カテゴリー名で検索するKeepaのAPIです。
詳しくは下記記事で説明しています。
リクエストのレスポンス
応答には、Best Sellers objectを持つ bestSellersListフィールドが含まれています。
指定されたカテゴリとロケールのリストが見つからない場合、応答は空になります (この場合、トークンは消費されません)。
以上です！
リクエストのレスポンスについては、下記の記事で詳しく解説しています。
