プログラミング PR

【Keepa APIの使い方】公式レファレンスを日本語訳してみました【Product Finder】

  /

Keepa APIのリクエストの1つ、「Product Finder」の公式レファレンスを日本語訳しました。

ASINを指定して情報を取得するのではなく、条件を指定してASINを抽出するリクエストです。

KeepaのWebサイトにあるProduct FinderのAPI版ですね。

検索条件が多いためレファレンスも長い…。
ぶっちゃけ、Webサイト版を触ってみた方が理解が早いと思います（笑）
Webサイト版で「SHOW API QUERY」ボタンを押せば、検索条件のQueryパラメータ表記を確認することもできます。

ただ、正確な条件を確認するニーズもあると思いますので、公式レファレンスは一読の価値はあるかと。

それでは、↓から日本語訳スタートです！

  • 「参考」で囲った部分は筆者の補足です。
  • 適宜サブタイトルの追加や、意訳を実施しています。
  • Keepaから翻訳の許可を頂いております。

こちら↓↓↓の記事に全てのKeepa APIに関する日本語訳記事をまとめているので、他のレファレンスも確認したい場合はご参考ください！

【Keepa APIの使い方】公式レファレンス日本語訳のまとめ 当ブログで投稿してきたKeepa APIの公式レファレンス(英語)の日本語訳解説のまとめ記事です。 Google翻訳でページ一括...
目次
  1. リクエストの基本情報

リクエストの基本情報

消費トークン

10トークン + 1トークン / 100 ASIN

指定した条件に一致する製品をデータベースで検索します。

ほぼすべての製品フィールドで検索およびソートできます。このリクエストは、Product Finderと同じコア機能を提供します。

  • このリクエストは、商品オブジェクトではなく、ASIN リストのみを返します。
  • 各リクエストは、10 個のトークンと、結果セット内の 100 個の ASIN ごとに追加のトークンを消費します。
  • クエリは、ページングを使用して最大 10,000 個の ASIN を返すことができ、最小ページサイズは 50 個の ASIN です。
    ページングを使用している場合、最初の検索結果はキャッシュされないため、連続するページ リクエスト間に時間がある場合、個々のページ間で結果の順序が正しくない可能性があります。

    注: すべての API リクエストは、現在のトークン バランスに関係なく (プラスである限り) 実行されます。
    大きな結果セットをリクエストすると、トークンの残高がマイナスになる可能性があります。
    注意して使用してください！
  • フィルターは AND 条件で結合されます。
  • 複数のエントリ (すべての配列) を許可するフィルターの場合、指定された各エントリは OR 条件で考慮され、最大 50 のエントリがサポートされます。
  • 製品クエリは、Amazon ではなく、当社のデータベースを検索します。クエリに一致するすべての商品が Amazon で見つかるとは限りません。
  • 製品データは常に変化します。同じクエリを 2 回実行すると、結果が異なる場合があります。
    これは、クエリ実行中の最近の変更または更新により、製品が誤って配置される可能性があるためです。

リクエストのQueryパラメータ

HTTP GET または POST 要求のいずれかを選択できます。

GET形式

/query?key=<yourAccessKey>&domain=<domainId>&selection=<queryJSON>
  • <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 ]
  • <queryJSON>
    queryJSON にはすべてのリクエスト パラメータが含まれます。
    GET 形式を使用する場合は、URL エンコードする必要があります。

POST形式

/query?domain=<domainId>&key=<yourAccessKey>
  • <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 ]
  • POST ペイロードには <queryJSON> が含まれている必要があります

queryJSONの形式

{
	"page": Integer,
	"perPage": Integer,
	"rootCategory": Long,
  	"categories_include": Long array,
	"categories_exclude": Long array,
	"manufacturer": String array,
	"title": String,
	"singleVariation": Boolean,
	"lastPriceChange_lte": Integer,
	"lastPriceChange_gte": Integer,
	"lastOffersUpdate_lte": Integer,
	"lastOffersUpdate_gte": Integer,	
	"productType": Integer,
	"hasParentASIN": Boolean,
	"hasReviews": Boolean,
	"trackingSince_lte": Integer,
	"trackingSince_gte": Integer,
	"brand": String array,
	"productGroup": String array,
	"partNumber": String array,
	"model": String array,
	"color": String array,
	"size": String array,
	"edition": String array,
	"format": String array,
	"packageHeight_lte": Integer,
	"packageHeight_gte": Integer,
	"packageLength_lte": Integer,
	"packageLength_gte": Integer,
	"packageWidth_lte": Integer,
	"packageWidth_gte": Integer,
	"packageWeight_lte": Integer,
	"packageWeight_gte": Integer,,
	"itemHeight_lte": Integer,
	"itemHeight_gte": Integer,
	"itemLength_lte": Integer,
	"itemLength_gte": Integer,
	"itemWidth_lte": Integer,
	"itemWidth_gte": Integer,
	"itemWeight_lte": Integer,
	"itemWeight_gte": Integer,
	"outOfStockPercentage90_lte": Integer,
	"outOfStockPercentage90_gte": Integer,
	"isAdultProduct": Boolean,
	"isEligibleForTradeIn": Boolean,
	"isEligibleForSuperSaverShipping": Boolean,
	"isSNS": Boolean,
	"author": String array,
	"binding": String array,
	"numberOfItems_lte": Integer,
	"numberOfItems_gte": Integer,
	"numberOfPages_lte": Integer,
	"numberOfPages_gte": Integer,
	"publicationDate_lte": Integer,
	"publicationDate_gte": Integer,
	"releaseDate_lte": Integer,
	"releaseDate_gte": Integer,
	"isPrimeExclusive": Boolean,
	"lightningEnd_lte": Integer,
	"lightningEnd_gte": Integer
	"current_AMAZON_lte": Integer,
	"current_AMAZON_gte": Integer,
	"current_NEW_lte": Integer,
	"current_NEW_gte": Integer,
	"current_USED_lte": Integer,
	"current_USED_gte": Integer,
	"current_SALES_lte": Integer,
	"current_SALES_gte": Integer,
	"current_LISTPRICE_lte": Integer,
	"current_LISTPRICE_gte": Integer,
	"current_COLLECTIBLE_lte": Integer,
	"current_COLLECTIBLE_gte": Integer,
	"current_REFURBISHED_lte": Integer,
	"current_REFURBISHED_gte": Integer,
	"current_NEW_FBM_SHIPPING_lte": Integer,
	"current_NEW_FBM_SHIPPING_gte": Integer,
	"current_LIGHTNING_DEAL_lte": Integer,
	"current_LIGHTNING_DEAL_gte": Integer,
	"current_WAREHOUSE_lte": Integer,
	"current_WAREHOUSE_gte": Integer,
	"current_NEW_FBA_lte": Integer,
	"current_NEW_FBA_gte": Integer,
	"current_COUNT_NEW_lte": Integer,
	"current_COUNT_NEW_gte": Integer,
	"current_COUNT_USED_lte": Integer,
	"current_COUNT_USED_gte": Integer,
	"current_COUNT_REFURBISHED_lte": Integer,
	"current_COUNT_REFURBISHED_gte": Integer,
	"current_COUNT_COLLECTIBLE_lte": Integer,
	"current_COUNT_COLLECTIBLE_gte": Integer,
	"current_RATING_lte": Integer,
	"current_RATING_gte": Integer,
	"current_COUNT_REVIEWS_lte": Integer,
	"current_COUNT_REVIEWS_gte": Integer,
	"current_BUY_BOX_SHIPPING_lte": Integer,
	"current_BUY_BOX_SHIPPING_gte": Integer,
	"current_USED_NEW_SHIPPING_lte": Integer,
	"current_USED_NEW_SHIPPING_gte": Integer,
	"current_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"current_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"current_USED_GOOD_SHIPPING_lte": Integer,
	"current_USED_GOOD_SHIPPING_gte": Integer,
	"current_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"current_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"current_REFURBISHED_SHIPPING_lte": Integer,
	"current_REFURBISHED_SHIPPING_gte": Integer,
	"current_TRADE_IN_lte": Integer,
	"current_TRADE_IN_gte": Integer,
	"delta90_AMAZON_lte": Integer,
	"delta90_AMAZON_gte": Integer,
	"delta90_NEW_lte": Integer,
	"delta90_NEW_gte": Integer,
	"delta90_USED_lte": Integer,
	"delta90_USED_gte": Integer,
	"delta90_SALES_lte": Integer,
	"delta90_SALES_gte": Integer,
	"delta90_LISTPRICE_lte": Integer,
	"delta90_LISTPRICE_gte": Integer,
	"delta90_COLLECTIBLE_lte": Integer,
	"delta90_COLLECTIBLE_gte": Integer,
	"delta90_REFURBISHED_lte": Integer,
	"delta90_REFURBISHED_gte": Integer,
	"delta90_NEW_FBM_SHIPPING_lte": Integer,
	"delta90_NEW_FBM_SHIPPING_gte": Integer,
	"delta90_LIGHTNING_DEAL_lte": Integer,
	"delta90_LIGHTNING_DEAL_gte": Integer,
	"delta90_WAREHOUSE_lte": Integer,
	"delta90_WAREHOUSE_gte": Integer,
	"delta90_NEW_FBA_lte": Integer,
	"delta90_NEW_FBA_gte": Integer,
	"delta90_COUNT_NEW_lte": Integer,
	"delta90_COUNT_NEW_gte": Integer,
	"delta90_COUNT_USED_lte": Integer,
	"delta90_COUNT_USED_gte": Integer,
	"delta90_COUNT_REFURBISHED_lte": Integer,
	"delta90_COUNT_REFURBISHED_gte": Integer,
	"delta90_COUNT_COLLECTIBLE_lte": Integer,
	"delta90_COUNT_COLLECTIBLE_gte": Integer,
	"delta90_RATING_lte": Integer,
	"delta90_RATING_gte": Integer,
	"delta90_COUNT_REVIEWS_lte": Integer,
	"delta90_COUNT_REVIEWS_gte": Integer,
	"delta90_BUY_BOX_SHIPPING_lte": Integer,
	"delta90_BUY_BOX_SHIPPING_gte": Integer,
	"delta90_USED_NEW_SHIPPING_lte": Integer,
	"delta90_USED_NEW_SHIPPING_gte": Integer,
	"delta90_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"delta90_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"delta90_USED_GOOD_SHIPPING_lte": Integer,
	"delta90_USED_GOOD_SHIPPING_gte": Integer,
	"delta90_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"delta90_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"delta90_REFURBISHED_SHIPPING_lte": Integer,
	"delta90_REFURBISHED_SHIPPING_gte": Integer,
	"delta90_TRADE_IN_lte": Integer,
	"delta90_TRADE_IN_gte": Integer,
	"delta30_AMAZON_lte": Integer,
	"delta30_AMAZON_gte": Integer,
	"delta30_NEW_lte": Integer,
	"delta30_NEW_gte": Integer,
	"delta30_USED_lte": Integer,
	"delta30_USED_gte": Integer,
	"delta30_SALES_lte": Integer,
	"delta30_SALES_gte": Integer,
	"delta30_LISTPRICE_lte": Integer,
	"delta30_LISTPRICE_gte": Integer,
	"delta30_COLLECTIBLE_lte": Integer,
	"delta30_COLLECTIBLE_gte": Integer,
	"delta30_REFURBISHED_lte": Integer,
	"delta30_REFURBISHED_gte": Integer,
	"delta30_NEW_FBM_SHIPPING_lte": Integer,
	"delta30_NEW_FBM_SHIPPING_gte": Integer,
	"delta30_LIGHTNING_DEAL_lte": Integer,
	"delta30_LIGHTNING_DEAL_gte": Integer,
	"delta30_WAREHOUSE_lte": Integer,
	"delta30_WAREHOUSE_gte": Integer,
	"delta30_NEW_FBA_lte": Integer,
	"delta30_NEW_FBA_gte": Integer,
	"delta30_COUNT_NEW_lte": Integer,
	"delta30_COUNT_NEW_gte": Integer,
	"delta30_COUNT_USED_lte": Integer,
	"delta30_COUNT_USED_gte": Integer,
	"delta30_COUNT_REFURBISHED_lte": Integer,
	"delta30_COUNT_REFURBISHED_gte": Integer,
	"delta30_COUNT_COLLECTIBLE_lte": Integer,
	"delta30_COUNT_COLLECTIBLE_gte": Integer,
	"delta30_RATING_lte": Integer,
	"delta30_RATING_gte": Integer,
	"delta30_COUNT_REVIEWS_lte": Integer,
	"delta30_COUNT_REVIEWS_gte": Integer,
	"delta30_BUY_BOX_SHIPPING_lte": Integer,
	"delta30_BUY_BOX_SHIPPING_gte": Integer,
	"delta30_USED_NEW_SHIPPING_lte": Integer,
	"delta30_USED_NEW_SHIPPING_gte": Integer,
	"delta30_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"delta30_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"delta30_USED_GOOD_SHIPPING_lte": Integer,
	"delta30_USED_GOOD_SHIPPING_gte": Integer,
	"delta30_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"delta30_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"delta30_REFURBISHED_SHIPPING_lte": Integer,
	"delta30_REFURBISHED_SHIPPING_gte": Integer,
	"delta30_TRADE_IN_lte": Integer,
	"delta30_TRADE_IN_gte": Integer,
	"deltaPercent90_AMAZON_lte": Integer,
	"deltaPercent90_AMAZON_gte": Integer,
	"deltaPercent90_NEW_lte": Integer,
	"deltaPercent90_NEW_gte": Integer,
	"deltaPercent90_USED_lte": Integer,
	"deltaPercent90_USED_gte": Integer,
	"deltaPercent90_SALES_lte": Integer,
	"deltaPercent90_SALES_gte": Integer,
	"deltaPercent90_LISTPRICE_lte": Integer,
	"deltaPercent90_LISTPRICE_gte": Integer,
	"deltaPercent90_COLLECTIBLE_lte": Integer,
	"deltaPercent90_COLLECTIBLE_gte": Integer,
	"deltaPercent90_REFURBISHED_lte": Integer,
	"deltaPercent90_REFURBISHED_gte": Integer,
	"deltaPercent90_NEW_FBM_SHIPPING_lte": Integer,
	"deltaPercent90_NEW_FBM_SHIPPING_gte": Integer,
	"deltaPercent90_LIGHTNING_DEAL_lte": Integer,
	"deltaPercent90_LIGHTNING_DEAL_gte": Integer,
	"deltaPercent90_WAREHOUSE_lte": Integer,
	"deltaPercent90_WAREHOUSE_gte": Integer,
	"deltaPercent90_NEW_FBA_lte": Integer,
	"deltaPercent90_NEW_FBA_gte": Integer,
	"deltaPercent90_COUNT_NEW_lte": Integer,
	"deltaPercent90_COUNT_NEW_gte": Integer,
	"deltaPercent90_COUNT_USED_lte": Integer,
	"deltaPercent90_COUNT_USED_gte": Integer,
	"deltaPercent90_COUNT_REFURBISHED_lte": Integer,
	"deltaPercent90_COUNT_REFURBISHED_gte": Integer,
	"deltaPercent90_COUNT_COLLECTIBLE_lte": Integer,
	"deltaPercent90_COUNT_COLLECTIBLE_gte": Integer,
	"deltaPercent90_RATING_lte": Integer,
	"deltaPercent90_RATING_gte": Integer,
	"deltaPercent90_COUNT_REVIEWS_lte": Integer,
	"deltaPercent90_COUNT_REVIEWS_gte": Integer,
	"deltaPercent90_BUY_BOX_SHIPPING_lte": Integer,
	"deltaPercent90_BUY_BOX_SHIPPING_gte": Integer,
	"deltaPercent90_USED_NEW_SHIPPING_lte": Integer,
	"deltaPercent90_USED_NEW_SHIPPING_gte": Integer,
	"deltaPercent90_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"deltaPercent90_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"deltaPercent90_USED_GOOD_SHIPPING_lte": Integer,
	"deltaPercent90_USED_GOOD_SHIPPING_gte": Integer,
	"deltaPercent90_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"deltaPercent90_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"deltaPercent90_REFURBISHED_SHIPPING_lte": Integer,
	"deltaPercent90_REFURBISHED_SHIPPING_gte": Integer,
	"deltaPercent90_TRADE_IN_lte": Integer,
	"deltaPercent90_TRADE_IN_gte": Integer,
	"deltaPercent30_AMAZON_lte": Integer,
	"deltaPercent30_AMAZON_gte": Integer,
	"deltaPercent30_NEW_lte": Integer,
	"deltaPercent30_NEW_gte": Integer,
	"deltaPercent30_USED_lte": Integer,
	"deltaPercent30_USED_gte": Integer,
	"deltaPercent30_SALES_lte": Integer,
	"deltaPercent30_SALES_gte": Integer,
	"deltaPercent30_LISTPRICE_lte": Integer,
	"deltaPercent30_LISTPRICE_gte": Integer,
	"deltaPercent30_COLLECTIBLE_lte": Integer,
	"deltaPercent30_COLLECTIBLE_gte": Integer,
	"deltaPercent30_REFURBISHED_lte": Integer,
	"deltaPercent30_REFURBISHED_gte": Integer,
	"deltaPercent30_NEW_FBM_SHIPPING_lte": Integer,
	"deltaPercent30_NEW_FBM_SHIPPING_gte": Integer,
	"deltaPercent30_LIGHTNING_DEAL_lte": Integer,
	"deltaPercent30_LIGHTNING_DEAL_gte": Integer,
	"deltaPercent30_WAREHOUSE_lte": Integer,
	"deltaPercent30_WAREHOUSE_gte": Integer,
	"deltaPercent30_NEW_FBA_lte": Integer,
	"deltaPercent30_NEW_FBA_gte": Integer,
	"deltaPercent30_COUNT_NEW_lte": Integer,
	"deltaPercent30_COUNT_NEW_gte": Integer,
	"deltaPercent30_COUNT_USED_lte": Integer,
	"deltaPercent30_COUNT_USED_gte": Integer,
	"deltaPercent30_COUNT_REFURBISHED_lte": Integer,
	"deltaPercent30_COUNT_REFURBISHED_gte": Integer,
	"deltaPercent30_COUNT_COLLECTIBLE_lte": Integer,
	"deltaPercent30_COUNT_COLLECTIBLE_gte": Integer,
	"deltaPercent30_RATING_lte": Integer,
	"deltaPercent30_RATING_gte": Integer,
	"deltaPercent30_COUNT_REVIEWS_lte": Integer,
	"deltaPercent30_COUNT_REVIEWS_gte": Integer,
	"deltaPercent30_BUY_BOX_SHIPPING_lte": Integer,
	"deltaPercent30_BUY_BOX_SHIPPING_gte": Integer,
	"deltaPercent30_USED_NEW_SHIPPING_lte": Integer,
	"deltaPercent30_USED_NEW_SHIPPING_gte": Integer,
	"deltaPercent30_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"deltaPercent30_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"deltaPercent30_USED_GOOD_SHIPPING_lte": Integer,
	"deltaPercent30_USED_GOOD_SHIPPING_gte": Integer,
	"deltaPercent30_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"deltaPercent30_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"deltaPercent30_REFURBISHED_SHIPPING_lte": Integer,
	"deltaPercent30_REFURBISHED_SHIPPING_gte": Integer,
	"deltaPercent30_TRADE_IN_lte": Integer,
	"deltaPercent30_TRADE_IN_gte": Integer,
	"deltaLast_AMAZON_lte": Integer,
	"deltaLast_AMAZON_gte": Integer,
	"deltaLast_NEW_lte": Integer,
	"deltaLast_NEW_gte": Integer,
	"deltaLast_USED_lte": Integer,
	"deltaLast_USED_gte": Integer,
	"deltaLast_SALES_lte": Integer,
	"deltaLast_SALES_gte": Integer,
	"deltaLast_LISTPRICE_lte": Integer,
	"deltaLast_LISTPRICE_gte": Integer,
	"deltaLast_COLLECTIBLE_lte": Integer,
	"deltaLast_COLLECTIBLE_gte": Integer,
	"deltaLast_REFURBISHED_lte": Integer,
	"deltaLast_REFURBISHED_gte": Integer,
	"deltaLast_NEW_FBM_SHIPPING_lte": Integer,
	"deltaLast_NEW_FBM_SHIPPING_gte": Integer,
	"deltaLast_LIGHTNING_DEAL_lte": Integer,
	"deltaLast_LIGHTNING_DEAL_gte": Integer,
	"deltaLast_WAREHOUSE_lte": Integer,
	"deltaLast_WAREHOUSE_gte": Integer,
	"deltaLast_NEW_FBA_lte": Integer,
	"deltaLast_NEW_FBA_gte": Integer,
	"deltaLast_COUNT_NEW_lte": Integer,
	"deltaLast_COUNT_NEW_gte": Integer,
	"deltaLast_COUNT_USED_lte": Integer,
	"deltaLast_COUNT_USED_gte": Integer,
	"deltaLast_COUNT_REFURBISHED_lte": Integer,
	"deltaLast_COUNT_REFURBISHED_gte": Integer,
	"deltaLast_COUNT_COLLECTIBLE_lte": Integer,
	"deltaLast_COUNT_COLLECTIBLE_gte": Integer,
	"deltaLast_RATING_lte": Integer,
	"deltaLast_RATING_gte": Integer,
	"deltaLast_COUNT_REVIEWS_lte": Integer,
	"deltaLast_COUNT_REVIEWS_gte": Integer,
	"deltaLast_BUY_BOX_SHIPPING_lte": Integer,
	"deltaLast_BUY_BOX_SHIPPING_gte": Integer,
	"deltaLast_USED_NEW_SHIPPING_lte": Integer,
	"deltaLast_USED_NEW_SHIPPING_gte": Integer,
	"deltaLast_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"deltaLast_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"deltaLast_USED_GOOD_SHIPPING_lte": Integer,
	"deltaLast_USED_GOOD_SHIPPING_gte": Integer,
	"deltaLast_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"deltaLast_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"deltaLast_REFURBISHED_SHIPPING_lte": Integer,
	"deltaLast_REFURBISHED_SHIPPING_gte": Integer,
	"deltaLast_TRADE_IN_lte": Integer,
	"deltaLast_TRADE_IN_gte": Integer,
	"avg180_AMAZON_lte": Integer,
	"avg180_AMAZON_gte": Integer,
	"avg180_NEW_lte": Integer,
	"avg180_NEW_gte": Integer,
	"avg180_USED_lte": Integer,
	"avg180_USED_gte": Integer,
	"avg180_SALES_lte": Integer,
	"avg180_SALES_gte": Integer,
	"avg180_LISTPRICE_lte": Integer,
	"avg180_LISTPRICE_gte": Integer,
	"avg180_COLLECTIBLE_lte": Integer,
	"avg180_COLLECTIBLE_gte": Integer,
	"avg180_REFURBISHED_lte": Integer,
	"avg180_REFURBISHED_gte": Integer,
	"avg180_NEW_FBM_SHIPPING_lte": Integer,
	"avg180_NEW_FBM_SHIPPING_gte": Integer,
	"avg180_LIGHTNING_DEAL_lte": Integer,
	"avg180_LIGHTNING_DEAL_gte": Integer,
	"avg180_WAREHOUSE_lte": Integer,
	"avg180_WAREHOUSE_gte": Integer,
	"avg180_NEW_FBA_lte": Integer,
	"avg180_NEW_FBA_gte": Integer,
	"avg180_COUNT_NEW_lte": Integer,
	"avg180_COUNT_NEW_gte": Integer,
	"avg180_COUNT_USED_lte": Integer,
	"avg180_COUNT_USED_gte": Integer,
	"avg180_COUNT_REFURBISHED_lte": Integer,
	"avg180_COUNT_REFURBISHED_gte": Integer,
	"avg180_COUNT_COLLECTIBLE_lte": Integer,
	"avg180_COUNT_COLLECTIBLE_gte": Integer,
	"avg180_RATING_lte": Integer,
	"avg180_RATING_gte": Integer,
	"avg180_COUNT_REVIEWS_lte": Integer,
	"avg180_COUNT_REVIEWS_gte": Integer,
	"avg180_BUY_BOX_SHIPPING_lte": Integer,
	"avg180_BUY_BOX_SHIPPING_gte": Integer,
	"avg180_USED_NEW_SHIPPING_lte": Integer,
	"avg180_USED_NEW_SHIPPING_gte": Integer,
	"avg180_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"avg180_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"avg180_USED_GOOD_SHIPPING_lte": Integer,
	"avg180_USED_GOOD_SHIPPING_gte": Integer,
	"avg180_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"avg180_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"avg180_REFURBISHED_SHIPPING_lte": Integer,
	"avg180_REFURBISHED_SHIPPING_gte": Integer,
	"avg180_TRADE_IN_lte": Integer,
	"avg180_TRADE_IN_gte": Integer,
	"avg90_AMAZON_lte": Integer,
	"avg90_AMAZON_gte": Integer,
	"avg90_NEW_lte": Integer,
	"avg90_NEW_gte": Integer,
	"avg90_USED_lte": Integer,
	"avg90_USED_gte": Integer,
	"avg90_SALES_lte": Integer,
	"avg90_SALES_gte": Integer,
	"avg90_LISTPRICE_lte": Integer,
	"avg90_LISTPRICE_gte": Integer,
	"avg90_COLLECTIBLE_lte": Integer,
	"avg90_COLLECTIBLE_gte": Integer,
	"avg90_REFURBISHED_lte": Integer,
	"avg90_REFURBISHED_gte": Integer,
	"avg90_NEW_FBM_SHIPPING_lte": Integer,
	"avg90_NEW_FBM_SHIPPING_gte": Integer,
	"avg90_LIGHTNING_DEAL_lte": Integer,
	"avg90_LIGHTNING_DEAL_gte": Integer,
	"avg90_WAREHOUSE_lte": Integer,
	"avg90_WAREHOUSE_gte": Integer,
	"avg90_NEW_FBA_lte": Integer,
	"avg90_NEW_FBA_gte": Integer,
	"avg90_COUNT_NEW_lte": Integer,
	"avg90_COUNT_NEW_gte": Integer,
	"avg90_COUNT_USED_lte": Integer,
	"avg90_COUNT_USED_gte": Integer,
	"avg90_COUNT_REFURBISHED_lte": Integer,
	"avg90_COUNT_REFURBISHED_gte": Integer,
	"avg90_COUNT_COLLECTIBLE_lte": Integer,
	"avg90_COUNT_COLLECTIBLE_gte": Integer,
	"avg90_RATING_lte": Integer,
	"avg90_RATING_gte": Integer,
	"avg90_COUNT_REVIEWS_lte": Integer,
	"avg90_COUNT_REVIEWS_gte": Integer,
	"avg90_BUY_BOX_SHIPPING_lte": Integer,
	"avg90_BUY_BOX_SHIPPING_gte": Integer,
	"avg90_USED_NEW_SHIPPING_lte": Integer,
	"avg90_USED_NEW_SHIPPING_gte": Integer,
	"avg90_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"avg90_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"avg90_USED_GOOD_SHIPPING_lte": Integer,
	"avg90_USED_GOOD_SHIPPING_gte": Integer,
	"avg90_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"avg90_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"avg90_REFURBISHED_SHIPPING_lte": Integer,
	"avg90_REFURBISHED_SHIPPING_gte": Integer,
	"avg90_TRADE_IN_lte": Integer,
	"avg90_TRADE_IN_gte": Integer,
	"avg30_AMAZON_lte": Integer,
	"avg30_AMAZON_gte": Integer,
	"avg30_NEW_lte": Integer,
	"avg30_NEW_gte": Integer,
	"avg30_USED_lte": Integer,
	"avg30_USED_gte": Integer,
	"avg30_SALES_lte": Integer,
	"avg30_SALES_gte": Integer,
	"avg30_LISTPRICE_lte": Integer,
	"avg30_LISTPRICE_gte": Integer,
	"avg30_COLLECTIBLE_lte": Integer,
	"avg30_COLLECTIBLE_gte": Integer,
	"avg30_REFURBISHED_lte": Integer,
	"avg30_REFURBISHED_gte": Integer,
	"avg30_NEW_FBM_SHIPPING_lte": Integer,
	"avg30_NEW_FBM_SHIPPING_gte": Integer,
	"avg30_LIGHTNING_DEAL_lte": Integer,
	"avg30_LIGHTNING_DEAL_gte": Integer,
	"avg30_WAREHOUSE_lte": Integer,
	"avg30_WAREHOUSE_gte": Integer,
	"avg30_NEW_FBA_lte": Integer,
	"avg30_NEW_FBA_gte": Integer,
	"avg30_COUNT_NEW_lte": Integer,
	"avg30_COUNT_NEW_gte": Integer,
	"avg30_COUNT_USED_lte": Integer,
	"avg30_COUNT_USED_gte": Integer,
	"avg30_COUNT_REFURBISHED_lte": Integer,
	"avg30_COUNT_REFURBISHED_gte": Integer,
	"avg30_COUNT_COLLECTIBLE_lte": Integer,
	"avg30_COUNT_COLLECTIBLE_gte": Integer,
	"avg30_RATING_lte": Integer,
	"avg30_RATING_gte": Integer,
	"avg30_COUNT_REVIEWS_lte": Integer,
	"avg30_COUNT_REVIEWS_gte": Integer,
	"avg30_BUY_BOX_SHIPPING_lte": Integer,
	"avg30_BUY_BOX_SHIPPING_gte": Integer,
	"avg30_USED_NEW_SHIPPING_lte": Integer,
	"avg30_USED_NEW_SHIPPING_gte": Integer,
	"avg30_USED_VERY_GOOD_SHIPPING_lte": Integer,
	"avg30_USED_VERY_GOOD_SHIPPING_gte": Integer,
	"avg30_USED_GOOD_SHIPPING_lte": Integer,
	"avg30_USED_GOOD_SHIPPING_gte": Integer,
	"avg30_USED_ACCEPTABLE_SHIPPING_lte": Integer,
	"avg30_USED_ACCEPTABLE_SHIPPING_gte": Integer,
	"avg30_REFURBISHED_SHIPPING_lte": Integer,
	"avg30_REFURBISHED_SHIPPING_gte": Integer,
	"avg30_TRADE_IN_lte": Integer,
	"avg30_TRADE_IN_gte": Integer,
	"backInStock_AMAZON": Boolean,
	"backInStock_NEW": Boolean,
	"backInStock_USED": Boolean,
	"backInStock_SALES": Boolean,
	"backInStock_LISTPRICE": Boolean,
	"backInStock_COLLECTIBLE": Boolean,
	"backInStock_REFURBISHED": Boolean,
	"backInStock_NEW_FBM_SHIPPING": Boolean,
	"backInStock_LIGHTNING_DEAL": Boolean,
	"backInStock_WAREHOUSE": Boolean,
	"backInStock_NEW_FBA": Boolean,
	"backInStock_COUNT_NEW": Boolean,
	"backInStock_COUNT_USED": Boolean,
	"backInStock_COUNT_REFURBISHED": Boolean,
	"backInStock_COUNT_COLLECTIBLE": Boolean,
	"backInStock_RATING": Boolean,
	"backInStock_COUNT_REVIEWS": Boolean,
	"backInStock_BUY_BOX_SHIPPING": Boolean,
	"backInStock_USED_NEW_SHIPPING": Boolean,
	"backInStock_USED_VERY_GOOD_SHIPPING": Boolean,
	"backInStock_USED_GOOD_SHIPPING": Boolean,
	"backInStock_USED_ACCEPTABLE_SHIPPING": Boolean,
	"backInStock_REFURBISHED_SHIPPING": Boolean,
	"backInStock_TRADE_IN": Boolean,
}
Paging

ページングは​​オプションです。
デフォルトでは、最大 50 件の結果が提供されます。

  • page:
    ほとんどのクエリには、50 を超える結果 (最小ページ サイズ) があります。
    追加の結果を取得するには、他のすべてのパラメーターを同一に保ちながら、pageパラメーターを繰り返します。
    ページ 0 から開始し、応答に含まれる結果が 50 件未満になったら終了します。

    各応答には、一致した製品の数を示す totalResults フィールドも含まれています。
    0 以外のページをリクエストする場合、page と perPage の組み合わせが 10,000 件を超えないようにする必要があります。
    値の例 : 0
  • perPage:
    ページごとに取得する結果の数を指定します。
    デフォルトおよび最小値は 50 ASIN です。
    0 以外のページが要求された場合、page と perPage の組み合わせが 10,000 件を超えてはなりません。
    page が 0 の場合、perPage は最大 10,000 になります。

    注: 大きなリストをリクエストすると、バケットで使用できるよりも多くのトークンが消費され、残高がマイナスになる可能性があります。注意して使用してください。

1ページ当たりperPage件表示した結果の、pageページ目のASINを取得するということです。

レスポンスサイズが大きくても問題なければ、

  • page = 0
  • perPage = 10,000

で、一気に取得可能な最大数をリクエストすれば良いかと思います。

Sorting

並べ替えはオプションです。
デフォルトでは、結果は現在の売上ランクの昇順で並べ替えられます。

  • sort:
    最大 3 つの並べ替え方向を含めることができます。
    2 次元配列を使用します。
    各エントリは次の形式である必要があります。
    [ fieldName, sortDirection ]
    • fieldName:
      以下のリストの任意のフィルターで、文字列または整数のいずれかです。
      fieldName に「_lte」または「_gte」を含めないでください。
    • sortDirection:
      昇順の場合は「asc」、降順の場合は「desc」を使用します。
      値の例: [ [“current_SALES”, “asc”] ]
Filters

すべてのフィルターはオプションです。
クエリは、少なくとも 1 つのフィルターが指定されている限り有効です。

次のフィールドはフィルターとして機能します。

すべてのフィルタに完全に一致する製品のみがクエリによって返されます。

すべての文字列フィルターは大文字と小文字を区別せず、接頭辞「✜」を使用して除外フィルターとして使用できます。

「_gte」で終わるフィルターは、出力を「以上」の値に制限し、「_lte」は「以下」を意味します。

  • rootCategory:
    商品のルート カテゴリのカテゴリ ノード ID。
    値の例 : 562066
  • categories_include:
    これらのサブカテゴリに直接リストされている商品のみを含めます。
    最大 50 個のカテゴリ ノード ID の配列。
    値の例 : [3010075031,12950651,355007011]
  • categories_exclude:
    これらのサブカテゴリに直接リストされている製品を除外します。
    最大 50 個のカテゴリ ノード ID の配列
    値の例 : [77028031,186606]
  • title:
    商品のタイトル。
    キーワードベースで機能します。
    つまり、製品のタイトルには、空白で区切られた指定された文字列のキーワードが含まれている必要があります。

    最大 50 個のキーワードをサポートします。
    検索では大文字と小文字が区別されません。
    キーワードの部分一致はサポートされていません。

    値の例 :
    • Digital Camera Canon:
      タイトルには、任意の順序または位置で、3 つのキーワードすべてを含める必要があります。
    • “Digital Camera” Canon:
      タイトルにはキーワード 「Digital Camera」 と 「Canon」 が含まれている必要があります。
    • -digital camera:
      タイトルにはキーワード digital を含めてはならず、camera を含める必要があります。
  • productType:
    製品で使用できるデータを決定します。
    可能なフィルター値:
    • 0 – 標準: すべてアクセス可能
    • 1 – ダウンロード可能: マーケットプレイス/サードパーティの価格データなし
    • 5 – VARIATION_PARENT: 商品は親 ASIN※ です。
      売上ランクとバリエーションCSVのみ設定されます。

※親ASINについて

親ASINとは、Amazonでバリエーション商品を登録する際に設定する、システム上の識別番号です。

例えば、TシャツでS, M, Lの3つのバリエーションの商品を出品する場合、下記のように親ASINの下に出品したい商品を紐づけて登録します。

  • 親ASIN
    • 子ASIN① Sサイズ
    • 子ASIN② Mサイズ
    • 子ASIN③ Lサイズ

あくまで親ASINはシステム管理上のASINなので、実際に販売されている商品のASINではありません。
上記例の場合、販売されているのは子ASIN①~③です。

  • singleVariation:
    true に設定すると、製品の 1 つのバリエーションのみが返されます。
  • hasParentASIN:
    商品に親 ASIN があるかどうか。
  • hasReviews:
    商品にレビューがあるかどうか。
  • manufacturer:
    製造業者の名前。
    例：Canon
  • brand:
    ブランドの名前。
    例：Canon
  • productGroup:
    製品グループの名前。
    例：apparel
  • model:
    モデルの名前。
    例: 2016
  • color:
    色の名前。
    例：black
  • size:
    サイズの名前。
    例：large
  • edition:
    エディションの名前。
    例：first edition
  • format:
    フォーマットの名前。
    例: CD-ROM
  • author:
    著者名。
    例: anonymous
  • binding:
    バインディングの名前。
    例：paperback
    ※筆者注 おそらくbindingは「製本」の意。
  • languages:
    言語の名前。
    例: english
  • partNumber:
    部品番号の名前。
    例：DSC-H300/BM-RB
  • lastPriceChange [_lte, _gte]:
    前回の価格変更 (任意の価格タイプ) が登録された時間 (Keepa time minutes単位)。
  • trackingSince [_lte, _gte]:
    この製品の追跡を開始した時刻を Keepa time minutesで示します。
    例: 3411319
  • lightningEnd [_lte, _gte]:
    定義された範囲内で終了する現在および今後のライトニング ディールを検索します。 (Keepa time minutes単)
Keepa time minutes について

何度か出現する「Keepa time minutes」は、keepa独自の時間単位です。
後述もされますが、補足しておきます。

一般的なUNIX時間(秒単位)に変更する場合は、

  • (Keepa time minutes + 21564000 ) × 60

で計算します。

  • packageHeight [_lte, _gte]:
    パッケージの高さ (ミリメートル単位)。
    例: 144
  • packageLength [_lte, _gte]:
    パッケージの長さ (ミリメートル単位)。
    例: 144
  • packageWidth [_lte, _gte]:
    パッケージの幅 (ミリメートル単位)。
    例: 144
  • packageWeight [_lte, _gte]:
    パッケージのグラム単位の重量。
    例：1500（＝1.5kg）
  • itemHeight [_lte, _gte]:
    アイテムの高さ (ミリメートル単位)。
    例: 144
  • itemLength [_lte, _gte]:
    アイテムの長さ (ミリメートル単位)。
    例: 144
  • itemWidth [_lte, _gte]:
    アイテムの幅 (ミリメートル単位)。
    例: 144
  • itemWeight [_lte, _gte]:
    商品のグラム単位の重量。
    例：1500（＝1.5kg）
  • outOfStockPercentage90 [_lte, _gte]:
    90 日間の Amazon 在庫切れ率。
    例: 0 = 在庫切れなし、100 = 100% の確率で在庫切れ、25 = 25% の確率で在庫切れ。
  • numberOfItems [_lte, _gte]:
    この商品の商品数です。
    例: 1
  • numberOfPages [_lte, _gte]:
    この商品のページ数です。
    例: 514
  • publicationDate [_lte, _gte]:
    アイテムの公開日 (Keepa Time 分単位)。
    例: 3411319
  • releaseDate [_lte, _gte]:
    アイテムのリリース日 (Keepa Time 分単位)。
    例: 3411319
  • lastOffersUpdate [_lte, _gte]:
    オファーが最後に更新された時間 (製品リクエストのオファー パラメータを参照)、Keepa Time 分単位。
    新しいオファー関連のデータを持つ製品のみを取得するために使用できます。
    例: 3411319
  • isPrimeExclusive:
    Prime 限定オファーは、購入者が有効な Prime サブスクリプションを持っている場合にのみ注文できます。
    例: true
  • isAdultProduct:
    アダルト商品かどうかを示します。
    例: true
  • isEligibleForTradeIn:
    製品が下取りの対象であるかどうか。
    例: true
  • isEligibleForSuperSaverShipping:
    商品がAmazonのスーパーセーバー配送※の対象かどうか。
    例: true
    ※筆者注 スーパーセーバー配送(super saver shipping)は25＄以上の購入で送料が無料になる、米国Amazonの制度。
    Product finderのWebページに該当の項目が無いので、日本では関係ないかも。
  • isSNS:
    商品のショッピング カート ボックスが定期おトク便対象の場合。
    例: true
    ※筆者注 上のリンクは米国Amazonのもの。
    日本版リンクはこちら
  • current [_PriceType] [_lte, _gte]:
    現在の価格または値をフィルターします。
    価格は、それぞれの Amazon ロケールの最小通貨単位 (ユーロ セントまたは円など) の整数です。
  • delta [30, 90] [_PriceType] [_lte, _gte]:
    現在の値と 30 日または 90 日間の平均値との絶対差をフィルター処理します。
    価格は、それぞれの Amazon ロケールの最小通貨単位 (ユーロ セントまたは円など) の整数です。

    負の値は価格が減少した場合にフィルターをかけ、正の値は増加したものにフィルターをかけます。
    0 は変更のない製品をフィルタリングします。
  • deltaPercent [30, 90] [_PriceType] [_lte, _gte]:
    現在の値と 30 日または 90 日間の平均値との相対的な差をフィルター処理します。
    0 ～ 100% のパーセンテージ。

    負の値は価格が減少した場合にフィルターをかけ、正の値は増加したものにフィルターをかけます。
    0 は変更のない製品をフィルタリングします。
  • deltaLast [_PriceType] [_lte, _gte]:
    現在の値と前の値の差をフィルタリングします。
    価格は、それぞれの Amazon ロケールの最小通貨単位 (ユーロ セントまたは円など) の整数です。

    負の値は価格が減少した場合にフィルターをかけ、正の値は増加したものにフィルターをかけます。
    0 は変更のない製品をフィルタリングします。
  • avg [7, 30, 90, 180] [_PriceType] [_lte, _gte]:
    それぞれの過去 x 日間の平均価格または値をフィルター処理します。
    価格は、それぞれの Amazon ロケールの最小通貨単位 (ユーロ セントまたは円など) の整数です。
  • backInStock [_PriceType]:
    価格/値が過去 60 日間に在庫切れになっていたかどうか、また現在オファーがあるかどうか。
Keepa Time minutes について:

すべてのタイムスタンプに使用される時刻形式。
Unix エポック タイムスタンプから Keepa Time Minutes を取得するには、それを 60 で割り (タイムスタンプが秒単位の場合、ミリ秒単位の場合は 60000)、21564000 を引きます。

Queryの例

{
  "rootCategory": 3167641,
  "current_AMAZON_lte": 5000,
  "current_AMAZON_gte": 1000,
  "perPage": 100,
  "page": 0
}

Product Finder インターフェイスを使用してクエリを作成することもできます。
現在のクエリは、結果テーブルの上にある 「Show API query」 をクリックして確認できます。

Product FinderのWebページで検索条件を指定すると、その条件をAPIで指定する際のQueryパラメータのコードが確認できます。

Webページでは日本語訳されている検索項目も多いです。
また、このレファレンスでは説明のないパラメータもある(!)ので、実際にWeb版を使用してみた後、Queryパラメータのコードを書くことを強くおススメします！

Queryのレスポンス

{
    "asinList" : String array,
    "totalResults" : Integer,
}
  • asinList
    結果の ASIN を含む順序付けられた配列
  • totalResults
    一致したすべての商品の推定数。

以上です！

Keepa
RELATED POST