Keepa Product Finder — 完整字段参考

本页是 keepa_product_finder 和 HTTP API ProductFinder 的共用字段参考。

---

一、价格/排名范围参数

以下每个 TYPE 对应一个价格/排名指标。每个时间窗口生成一对 _gte / _lte 参数，成对放在同一行。

1.1 SALES — Sales Rank（单位：整数）

参数	类型	取值	说明
SALES_outOfStock	boolean	true / false	排除无 Sales Rank 的商品
SALES_isLowest	boolean	true / false	仅限该指标历史最低
SALES_isLowest90	boolean	true / false	仅限 90 天内最低
SALES_current_gte / SALES_current_lte	int	≥ 1	当前 Sales Rank 范围
SALES_avg30_gte / SALES_avg30_lte	int	≥ 1	30 天平均排名
SALES_avg90_gte / SALES_avg90_lte	int	≥ 1	90 天平均排名
SALES_avg180_gte / SALES_avg180_lte	int	≥ 1	180 天平均排名
SALES_avg365_gte / SALES_avg365_lte	int	≥ 1	365 天平均排名
SALES_deltaPercent1_gte / SALES_deltaPercent1_lte	int	百分比	1 天排名变化 %
SALES_deltaPercent7_gte / SALES_deltaPercent7_lte	int	百分比	7 天排名变化 %
SALES_deltaPercent30_gte / SALES_deltaPercent30_lte	int	百分比	30 天排名变化 %
SALES_deltaPercent90_gte / SALES_deltaPercent90_lte	int	百分比	90 天排名变化 %

1.2 BUY_BOX_SHIPPING — Buy Box 价格含运费（单位：cents 分）

参数	类型	取值	说明
BUY_BOX_SHIPPING_outOfStock	boolean	true / false	排除 Buy Box 缺货商品
BUY_BOX_SHIPPING_isLowest	boolean	true / false	仅限历史最低
BUY_BOX_SHIPPING_isLowest90	boolean	true / false	仅限 90 天内最低
BUY_BOX_SHIPPING_current_gte / BUY_BOX_SHIPPING_current_lte	int	cents，≥ 0	当前 Buy Box 价格范围
BUY_BOX_SHIPPING_avg30_gte / BUY_BOX_SHIPPING_avg30_lte	int	cents	30 天均值
BUY_BOX_SHIPPING_avg90_gte / BUY_BOX_SHIPPING_avg90_lte	int	cents	90 天均值
BUY_BOX_SHIPPING_avg180_gte / BUY_BOX_SHIPPING_avg180_lte	int	cents	180 天均值
BUY_BOX_SHIPPING_avg365_gte / BUY_BOX_SHIPPING_avg365_lte	int	cents	365 天均值
BUY_BOX_SHIPPING_deltaPercent1_gte / BUY_BOX_SHIPPING_deltaPercent1_lte	int	百分比	1 天变化 %
BUY_BOX_SHIPPING_deltaPercent7_gte / BUY_BOX_SHIPPING_deltaPercent7_lte	int	百分比	7 天变化 %
BUY_BOX_SHIPPING_deltaPercent30_gte / BUY_BOX_SHIPPING_deltaPercent30_lte	int	百分比	30 天变化 %
BUY_BOX_SHIPPING_deltaPercent90_gte / BUY_BOX_SHIPPING_deltaPercent90_lte	int	百分比	90 天变化 %

1.3 AMAZON — Amazon 自营价格（单位：cents）

参数	类型	取值	说明
AMAZON_outOfStock	boolean	true / false	排除缺货
AMAZON_isLowest	boolean	true / false	仅限历史最低
AMAZON_isLowest90	boolean	true / false	仅限 90 天内最低
AMAZON_current_gte / AMAZON_current_lte	int	cents	当前 Amazon 价格
AMAZON_avg30_gte / AMAZON_avg30_lte	int	cents	30 天均值
AMAZON_avg90_gte / AMAZON_avg90_lte	int	cents	90 天均值
AMAZON_avg180_gte / AMAZON_avg180_lte	int	cents	180 天均值
AMAZON_avg365_gte / AMAZON_avg365_lte	int	cents	365 天均值
AMAZON_deltaPercent1_gte / AMAZON_deltaPercent1_lte	int	百分比	1 天变化 %
AMAZON_deltaPercent7_gte / AMAZON_deltaPercent7_lte	int	百分比	7 天变化 %
AMAZON_deltaPercent30_gte / AMAZON_deltaPercent30_lte	int	百分比	30 天变化 %
AMAZON_deltaPercent90_gte / AMAZON_deltaPercent90_lte	int	百分比	90 天变化 %

1.4 NEW — 全新品价格（单位：cents）

参数	类型	取值	说明
NEW_outOfStock	boolean	true / false	排除缺货
NEW_isLowest	boolean	true / false	仅限历史最低
NEW_isLowest90	boolean	true / false	仅限 90 天内最低
NEW_current_gte / NEW_current_lte	int	cents	当前全新品价格
NEW_avg30_gte / NEW_avg30_lte	int	cents	30 天均值
NEW_avg90_gte / NEW_avg90_lte	int	cents	90 天均值
NEW_avg180_gte / NEW_avg180_lte	int	cents	180 天均值
NEW_avg365_gte / NEW_avg365_lte	int	cents	365 天均值
NEW_deltaPercent1_gte / NEW_deltaPercent1_lte	int	百分比	1 天变化 %
NEW_deltaPercent7_gte / NEW_deltaPercent7_lte	int	百分比	7 天变化 %
NEW_deltaPercent30_gte / NEW_deltaPercent30_lte	int	百分比	30 天变化 %
NEW_deltaPercent90_gte / NEW_deltaPercent90_lte	int	百分比	90 天变化 %

1.5 NEW_FBA — New FBA 价格（单位：cents）

参数	类型	取值	说明
NEW_FBA_outOfStock	boolean	true / false	排除缺货
NEW_FBA_isLowest	boolean	true / false	仅限历史最低
NEW_FBA_isLowest90	boolean	true / false	仅限 90 天内最低
NEW_FBA_current_gte / NEW_FBA_current_lte	int	cents	当前 New FBA 价格
NEW_FBA_avg30_gte / NEW_FBA_avg30_lte	int	cents	30 天均值
NEW_FBA_avg90_gte / NEW_FBA_avg90_lte	int	cents	90 天均值
NEW_FBA_avg180_gte / NEW_FBA_avg180_lte	int	cents	180 天均值
NEW_FBA_avg365_gte / NEW_FBA_avg365_lte	int	cents	365 天均值
NEW_FBA_deltaPercent1_gte / NEW_FBA_deltaPercent1_lte	int	百分比	1 天变化 %
NEW_FBA_deltaPercent7_gte / NEW_FBA_deltaPercent7_lte	int	百分比	7 天变化 %
NEW_FBA_deltaPercent30_gte / NEW_FBA_deltaPercent30_lte	int	百分比	30 天变化 %
NEW_FBA_deltaPercent90_gte / NEW_FBA_deltaPercent90_lte	int	百分比	90 天变化 %

1.6 NEW_FBM_SHIPPING — New FBM 价格含运费（单位：cents）

参数	类型	取值	说明
NEW_FBM_SHIPPING_outOfStock	boolean	true / false	排除缺货
NEW_FBM_SHIPPING_isLowest	boolean	true / false	仅限历史最低
NEW_FBM_SHIPPING_isLowest90	boolean	true / false	仅限 90 天内最低
NEW_FBM_SHIPPING_current_gte / NEW_FBM_SHIPPING_current_lte	int	cents	当前 New FBM 价格
NEW_FBM_SHIPPING_avg30_gte / NEW_FBM_SHIPPING_avg30_lte	int	cents	30 天均值
NEW_FBM_SHIPPING_avg90_gte / NEW_FBM_SHIPPING_avg90_lte	int	cents	90 天均值
NEW_FBM_SHIPPING_avg180_gte / NEW_FBM_SHIPPING_avg180_lte	int	cents	180 天均值
NEW_FBM_SHIPPING_avg365_gte / NEW_FBM_SHIPPING_avg365_lte	int	cents	365 天均值
NEW_FBM_SHIPPING_deltaPercent1_gte / NEW_FBM_SHIPPING_deltaPercent1_lte	int	百分比	1 天变化 %
NEW_FBM_SHIPPING_deltaPercent7_gte / NEW_FBM_SHIPPING_deltaPercent7_lte	int	百分比	7 天变化 %
NEW_FBM_SHIPPING_deltaPercent30_gte / NEW_FBM_SHIPPING_deltaPercent30_lte	int	百分比	30 天变化 %
NEW_FBM_SHIPPING_deltaPercent90_gte / NEW_FBM_SHIPPING_deltaPercent90_lte	int	百分比	90 天变化 %

1.7 USED — 非全新品价格（单位：cents）

参数	类型	取值	说明
USED_outOfStock	boolean	true / false	排除缺货
USED_isLowest	boolean	true / false	仅限历史最低
USED_isLowest90	boolean	true / false	仅限 90 天内最低
USED_current_gte / USED_current_lte	int	cents	当前非全新品价格
USED_avg30_gte / USED_avg30_lte	int	cents	30 天均值
USED_avg90_gte / USED_avg90_lte	int	cents	90 天均值
USED_avg180_gte / USED_avg180_lte	int	cents	180 天均值
USED_avg365_gte / USED_avg365_lte	int	cents	365 天均值
USED_deltaPercent1_gte / USED_deltaPercent1_lte	int	百分比	1 天变化 %
USED_deltaPercent7_gte / USED_deltaPercent7_lte	int	百分比	7 天变化 %
USED_deltaPercent30_gte / USED_deltaPercent30_lte	int	百分比	30 天变化 %
USED_deltaPercent90_gte / USED_deltaPercent90_lte	int	百分比	90 天变化 %

1.8 Used 成色子类型（单位：cents）

每个成色各自有独立的 current / avg30 / avg90 / avg180 / avg365 / deltaPercent / outOfStock / isLowest / isLowest90。

子类型	参数前缀	说明
Like New	USED_NEW_SHIPPING	Used - Like New 含运费
Very Good	USED_VERY_GOOD_SHIPPING	Used - Very Good 含运费
Good	USED_GOOD_SHIPPING	Used - Good 含运费
Acceptable	USED_ACCEPTABLE_SHIPPING	Used - Acceptable 含运费

例：USED_NEW_SHIPPING_current_gte / USED_NEW_SHIPPING_current_lte

1.9 PRIME_EXCL — Prime Exclusive 价格（单位：cents）

参数	类型	取值	说明
PRIME_EXCL_outOfStock	boolean	true / false	排除缺货
PRIME_EXCL_isLowest	boolean	true / false	仅限历史最低
PRIME_EXCL_isLowest90	boolean	true / false	仅限 90 天内最低
PRIME_EXCL_current_gte / PRIME_EXCL_current_lte	int	cents	当前价格
PRIME_EXCL_avg30_gte / PRIME_EXCL_avg30_lte	int	cents	30 天均值
PRIME_EXCL_avg90_gte / PRIME_EXCL_avg90_lte	int	cents	90 天均值
PRIME_EXCL_avg180_gte / PRIME_EXCL_avg180_lte	int	cents	180 天均值
PRIME_EXCL_avg365_gte / PRIME_EXCL_avg365_lte	int	cents	365 天均值
PRIME_EXCL_deltaPercent1_gte / PRIME_EXCL_deltaPercent1_lte	int	百分比	1 天变化 %
PRIME_EXCL_deltaPercent7_gte / PRIME_EXCL_deltaPercent7_lte	int	百分比	7 天变化 %
PRIME_EXCL_deltaPercent30_gte / PRIME_EXCL_deltaPercent30_lte	int	百分比	30 天变化 %
PRIME_EXCL_deltaPercent90_gte / PRIME_EXCL_deltaPercent90_lte	int	百分比	90 天变化 %

1.10 BUY_BOX_USED_SHIPPING — Buy Box Used 价格（单位：cents）

参数	类型	取值	说明
BUY_BOX_USED_SHIPPING_outOfStock	boolean	true / false	排除缺货
BUY_BOX_USED_SHIPPING_isLowest	boolean	true / false	仅限历史最低
BUY_BOX_USED_SHIPPING_isLowest90	boolean	true / false	仅限 90 天内最低
BUY_BOX_USED_SHIPPING_current_gte / BUY_BOX_USED_SHIPPING_current_lte	int	cents	当前价格
BUY_BOX_USED_SHIPPING_avg30_gte / BUY_BOX_USED_SHIPPING_avg30_lte	int	cents	30 天均值
BUY_BOX_USED_SHIPPING_avg90_gte / BUY_BOX_USED_SHIPPING_avg90_lte	int	cents	90 天均值
BUY_BOX_USED_SHIPPING_avg180_gte / BUY_BOX_USED_SHIPPING_avg180_lte	int	cents	180 天均值
BUY_BOX_USED_SHIPPING_avg365_gte / BUY_BOX_USED_SHIPPING_avg365_lte	int	cents	365 天均值
BUY_BOX_USED_SHIPPING_deltaPercent1_gte / BUY_BOX_USED_SHIPPING_deltaPercent1_lte	int	百分比	1 天变化 %
BUY_BOX_USED_SHIPPING_deltaPercent7_gte / BUY_BOX_USED_SHIPPING_deltaPercent7_lte	int	百分比	7 天变化 %
BUY_BOX_USED_SHIPPING_deltaPercent30_gte / BUY_BOX_USED_SHIPPING_deltaPercent30_lte	int	百分比	30 天变化 %
BUY_BOX_USED_SHIPPING_deltaPercent90_gte / BUY_BOX_USED_SHIPPING_deltaPercent90_lte	int	百分比	90 天变化 %

1.11 REFURBISHED — Refurbished 价格（单位：cents）

参数	类型	取值	说明
REFURBISHED_outOfStock	boolean	true / false	排除缺货
REFURBISHED_isLowest	boolean	true / false	仅限历史最低
REFURBISHED_isLowest90	boolean	true / false	仅限 90 天内最低
REFURBISHED_current_gte / REFURBISHED_current_lte	int	cents	当前价格
REFURBISHED_avg30_gte / REFURBISHED_avg30_lte	int	cents	30 天均值
REFURBISHED_avg90_gte / REFURBISHED_avg90_lte	int	cents	90 天均值
REFURBISHED_avg180_gte / REFURBISHED_avg180_lte	int	cents	180 天均值
REFURBISHED_avg365_gte / REFURBISHED_avg365_lte	int	cents	365 天均值
REFURBISHED_deltaPercent1_gte / REFURBISHED_deltaPercent1_lte	int	百分比	1 天变化 %
REFURBISHED_deltaPercent7_gte / REFURBISHED_deltaPercent7_lte	int	百分比	7 天变化 %
REFURBISHED_deltaPercent30_gte / REFURBISHED_deltaPercent30_lte	int	百分比	30 天变化 %
REFURBISHED_deltaPercent90_gte / REFURBISHED_deltaPercent90_lte	int	百分比	90 天变化 %

1.12 COLLECTIBLE — Collectible 价格（单位：cents）

参数	类型	取值	说明
COLLECTIBLE_outOfStock	boolean	true / false	排除缺货
COLLECTIBLE_isLowest	boolean	true / false	仅限历史最低
COLLECTIBLE_isLowest90	boolean	true / false	仅限 90 天内最低
COLLECTIBLE_current_gte / COLLECTIBLE_current_lte	int	cents	当前价格
COLLECTIBLE_avg30_gte / COLLECTIBLE_avg30_lte	int	cents	30 天均值
COLLECTIBLE_avg90_gte / COLLECTIBLE_avg90_lte	int	cents	90 天均值
COLLECTIBLE_avg180_gte / COLLECTIBLE_avg180_lte	int	cents	180 天均值
COLLECTIBLE_avg365_gte / COLLECTIBLE_avg365_lte	int	cents	365 天均值
COLLECTIBLE_deltaPercent1_gte / COLLECTIBLE_deltaPercent1_lte	int	百分比	1 天变化 %
COLLECTIBLE_deltaPercent7_gte / COLLECTIBLE_deltaPercent7_lte	int	百分比	7 天变化 %
COLLECTIBLE_deltaPercent30_gte / COLLECTIBLE_deltaPercent30_lte	int	百分比	30 天变化 %
COLLECTIBLE_deltaPercent90_gte / COLLECTIBLE_deltaPercent90_lte	int	百分比	90 天变化 %

1.13 WAREHOUSE — Warehouse Deals（单位：cents）

参数	类型	取值	说明
WAREHOUSE_outOfStock	boolean	true / false	排除缺货
WAREHOUSE_isLowest	boolean	true / false	仅限历史最低
WAREHOUSE_isLowest90	boolean	true / false	仅限 90 天内最低
WAREHOUSE_current_gte / WAREHOUSE_current_lte	int	cents	当前价格
WAREHOUSE_avg30_gte / WAREHOUSE_avg30_lte	int	cents	30 天均值
WAREHOUSE_avg90_gte / WAREHOUSE_avg90_lte	int	cents	90 天均值
WAREHOUSE_avg180_gte / WAREHOUSE_avg180_lte	int	cents	180 天均值
WAREHOUSE_avg365_gte / WAREHOUSE_avg365_lte	int	cents	365 天均值
WAREHOUSE_deltaPercent1_gte / WAREHOUSE_deltaPercent1_lte	int	百分比	1 天变化 %
WAREHOUSE_deltaPercent7_gte / WAREHOUSE_deltaPercent7_lte	int	百分比	7 天变化 %
WAREHOUSE_deltaPercent30_gte / WAREHOUSE_deltaPercent30_lte	int	百分比	30 天变化 %
WAREHOUSE_deltaPercent90_gte / WAREHOUSE_deltaPercent90_lte	int	百分比	90 天变化 %

1.14 TRADE_IN — Amazon Trade-In 回收价（单位：cents）

参数	类型	取值	说明
TRADE_IN_outOfStock	boolean	true / false	排除缺货
TRADE_IN_isLowest	boolean	true / false	仅限历史最低
TRADE_IN_isLowest90	boolean	true / false	仅限 90 天内最低
TRADE_IN_current_gte / TRADE_IN_current_lte	int	cents	当前回收价
TRADE_IN_avg30_gte / TRADE_IN_avg30_lte	int	cents	30 天均值
TRADE_IN_avg90_gte / TRADE_IN_avg90_lte	int	cents	90 天均值
TRADE_IN_avg180_gte / TRADE_IN_avg180_lte	int	cents	180 天均值
TRADE_IN_avg365_gte / TRADE_IN_avg365_lte	int	cents	365 天均值
TRADE_IN_deltaPercent1_gte / TRADE_IN_deltaPercent1_lte	int	百分比	1 天变化 %
TRADE_IN_deltaPercent7_gte / TRADE_IN_deltaPercent7_lte	int	百分比	7 天变化 %
TRADE_IN_deltaPercent30_gte / TRADE_IN_deltaPercent30_lte	int	百分比	30 天变化 %
TRADE_IN_deltaPercent90_gte / TRADE_IN_deltaPercent90_lte	int	百分比	90 天变化 %

1.15 EBAY_NEW_SHIPPING — eBay New 价格（单位：cents）

参数	类型	取值	说明
EBAY_NEW_SHIPPING_outOfStock	boolean	true / false	排除缺货
EBAY_NEW_SHIPPING_isLowest	boolean	true / false	仅限历史最低
EBAY_NEW_SHIPPING_isLowest90	boolean	true / false	仅限 90 天内最低
EBAY_NEW_SHIPPING_current_gte / EBAY_NEW_SHIPPING_current_lte	int	cents	当前价格
EBAY_NEW_SHIPPING_avg30_gte / EBAY_NEW_SHIPPING_avg30_lte	int	cents	30 天均值
EBAY_NEW_SHIPPING_avg90_gte / EBAY_NEW_SHIPPING_avg90_lte	int	cents	90 天均值
EBAY_NEW_SHIPPING_avg180_gte / EBAY_NEW_SHIPPING_avg180_lte	int	cents	180 天均值
EBAY_NEW_SHIPPING_avg365_gte / EBAY_NEW_SHIPPING_avg365_lte	int	cents	365 天均值
EBAY_NEW_SHIPPING_deltaPercent1_gte / EBAY_NEW_SHIPPING_deltaPercent1_lte	int	百分比	1 天变化 %
EBAY_NEW_SHIPPING_deltaPercent7_gte / EBAY_NEW_SHIPPING_deltaPercent7_lte	int	百分比	7 天变化 %
EBAY_NEW_SHIPPING_deltaPercent30_gte / EBAY_NEW_SHIPPING_deltaPercent30_lte	int	百分比	30 天变化 %
EBAY_NEW_SHIPPING_deltaPercent90_gte / EBAY_NEW_SHIPPING_deltaPercent90_lte	int	百分比	90 天变化 %

1.16 EBAY_USED_SHIPPING — eBay Used 价格（单位：cents）

参数	类型	取值	说明
EBAY_USED_SHIPPING_outOfStock	boolean	true / false	排除缺货
EBAY_USED_SHIPPING_isLowest	boolean	true / false	仅限历史最低
EBAY_USED_SHIPPING_isLowest90	boolean	true / false	仅限 90 天内最低
EBAY_USED_SHIPPING_current_gte / EBAY_USED_SHIPPING_current_lte	int	cents	当前价格
EBAY_USED_SHIPPING_avg30_gte / EBAY_USED_SHIPPING_avg30_lte	int	cents	30 天均值
EBAY_USED_SHIPPING_avg90_gte / EBAY_USED_SHIPPING_avg90_lte	int	cents	90 天均值
EBAY_USED_SHIPPING_avg180_gte / EBAY_USED_SHIPPING_avg180_lte	int	cents	180 天均值
EBAY_USED_SHIPPING_avg365_gte / EBAY_USED_SHIPPING_avg365_lte	int	cents	365 天均值
EBAY_USED_SHIPPING_deltaPercent1_gte / EBAY_USED_SHIPPING_deltaPercent1_lte	int	百分比	1 天变化 %
EBAY_USED_SHIPPING_deltaPercent7_gte / EBAY_USED_SHIPPING_deltaPercent7_lte	int	百分比	7 天变化 %
EBAY_USED_SHIPPING_deltaPercent30_gte / EBAY_USED_SHIPPING_deltaPercent30_lte	int	百分比	30 天变化 %
EBAY_USED_SHIPPING_deltaPercent90_gte / EBAY_USED_SHIPPING_deltaPercent90_lte	int	百分比	90 天变化 %

1.17 LISTPRICE — 标价（单位：cents）

注意：无 outOfStock。

参数	类型	取值	说明
LISTPRICE_isLowest	boolean	true / false	仅限历史最低
LISTPRICE_isLowest90	boolean	true / false	仅限 90 天内最低
LISTPRICE_current_gte / LISTPRICE_current_lte	int	cents	当前标价
LISTPRICE_avg30_gte / LISTPRICE_avg30_lte	int	cents	30 天均值
LISTPRICE_avg90_gte / LISTPRICE_avg90_lte	int	cents	90 天均值
LISTPRICE_avg180_gte / LISTPRICE_avg180_lte	int	cents	180 天均值
LISTPRICE_avg365_gte / LISTPRICE_avg365_lte	int	cents	365 天均值
LISTPRICE_deltaPercent1_gte / LISTPRICE_deltaPercent1_lte	int	百分比	1 天变化 %
LISTPRICE_deltaPercent7_gte / LISTPRICE_deltaPercent7_lte	int	百分比	7 天变化 %
LISTPRICE_deltaPercent30_gte / LISTPRICE_deltaPercent30_lte	int	百分比	30 天变化 %
LISTPRICE_deltaPercent90_gte / LISTPRICE_deltaPercent90_lte	int	百分比	90 天变化 %

1.18 LIGHTNING_DEAL — Lightning Deal 价格（单位：cents）

注意：仅有 current 窗口，无 outOfStock。

参数	类型	取值	说明
LIGHTNING_DEAL_isLowest	boolean	true / false	仅限历史最低
LIGHTNING_DEAL_isLowest90	boolean	true / false	仅限 90 天内最低
LIGHTNING_DEAL_current_gte / LIGHTNING_DEAL_current_lte	int	cents	当前 Lightning Deal 价格

---

二、Offer 数量

2.1 COUNT_NEW — New Offer 数

参数	类型	取值	说明
COUNT_NEW_current_gte / COUNT_NEW_current_lte	int	≥ 0	当前 New Offer 数
COUNT_NEW_avg30_gte / COUNT_NEW_avg30_lte	int	≥ 0	30 天均值
COUNT_NEW_avg90_gte / COUNT_NEW_avg90_lte	int	≥ 0	90 天均值
COUNT_NEW_avg180_gte / COUNT_NEW_avg180_lte	int	≥ 0	180 天均值
COUNT_NEW_avg365_gte / COUNT_NEW_avg365_lte	int	≥ 0	365 天均值
COUNT_NEW_deltaPercent1_gte / COUNT_NEW_deltaPercent1_lte	int	百分比	1 天变化 %
COUNT_NEW_deltaPercent7_gte / COUNT_NEW_deltaPercent7_lte	int	百分比	7 天变化 %
COUNT_NEW_deltaPercent30_gte / COUNT_NEW_deltaPercent30_lte	int	百分比	30 天变化 %
COUNT_NEW_deltaPercent90_gte / COUNT_NEW_deltaPercent90_lte	int	百分比	90 天变化 %

2.2 COUNT_NEW_FBA — New FBA Offer 数

参数	类型	取值	说明
COUNT_NEW_FBA_current_gte / COUNT_NEW_FBA_current_lte	int	≥ 0	当前 New FBA Offer 数
COUNT_NEW_FBA_avg30_gte / COUNT_NEW_FBA_avg30_lte	int	≥ 0	30 天均值
COUNT_NEW_FBA_avg90_gte / COUNT_NEW_FBA_avg90_lte	int	≥ 0	90 天均值
COUNT_NEW_FBA_avg180_gte / COUNT_NEW_FBA_avg180_lte	int	≥ 0	180 天均值
COUNT_NEW_FBA_avg365_gte / COUNT_NEW_FBA_avg365_lte	int	≥ 0	365 天均值
COUNT_NEW_FBA_deltaPercent1_gte / COUNT_NEW_FBA_deltaPercent1_lte	int	百分比	1 天变化 %
COUNT_NEW_FBA_deltaPercent7_gte / COUNT_NEW_FBA_deltaPercent7_lte	int	百分比	7 天变化 %
COUNT_NEW_FBA_deltaPercent30_gte / COUNT_NEW_FBA_deltaPercent30_lte	int	百分比	30 天变化 %
COUNT_NEW_FBA_deltaPercent90_gte / COUNT_NEW_FBA_deltaPercent90_lte	int	百分比	90 天变化 %

2.3 COUNT_NEW_FBM — New FBM Offer 数

参数	类型	取值	说明
COUNT_NEW_FBM_current_gte / COUNT_NEW_FBM_current_lte	int	≥ 0	当前 New FBM Offer 数
COUNT_NEW_FBM_avg30_gte / COUNT_NEW_FBM_avg30_lte	int	≥ 0	30 天均值
COUNT_NEW_FBM_avg90_gte / COUNT_NEW_FBM_avg90_lte	int	≥ 0	90 天均值
COUNT_NEW_FBM_avg180_gte / COUNT_NEW_FBM_avg180_lte	int	≥ 0	180 天均值
COUNT_NEW_FBM_avg365_gte / COUNT_NEW_FBM_avg365_lte	int	≥ 0	365 天均值
COUNT_NEW_FBM_deltaPercent1_gte / COUNT_NEW_FBM_deltaPercent1_lte	int	百分比	1 天变化 %
COUNT_NEW_FBM_deltaPercent7_gte / COUNT_NEW_FBM_deltaPercent7_lte	int	百分比	7 天变化 %
COUNT_NEW_FBM_deltaPercent30_gte / COUNT_NEW_FBM_deltaPercent30_lte	int	百分比	30 天变化 %
COUNT_NEW_FBM_deltaPercent90_gte / COUNT_NEW_FBM_deltaPercent90_lte	int	百分比	90 天变化 %

2.4 COUNT_USED — Used Offer 数

参数	类型	取值	说明
COUNT_USED_current_gte / COUNT_USED_current_lte	int	≥ 0	当前 Used Offer 数
COUNT_USED_avg30_gte / COUNT_USED_avg30_lte	int	≥ 0	30 天均值
COUNT_USED_avg90_gte / COUNT_USED_avg90_lte	int	≥ 0	90 天均值
COUNT_USED_avg180_gte / COUNT_USED_avg180_lte	int	≥ 0	180 天均值
COUNT_USED_avg365_gte / COUNT_USED_avg365_lte	int	≥ 0	365 天均值
COUNT_USED_deltaPercent1_gte / COUNT_USED_deltaPercent1_lte	int	百分比	1 天变化 %
COUNT_USED_deltaPercent7_gte / COUNT_USED_deltaPercent7_lte	int	百分比	7 天变化 %
COUNT_USED_deltaPercent30_gte / COUNT_USED_deltaPercent30_lte	int	百分比	30 天变化 %
COUNT_USED_deltaPercent90_gte / COUNT_USED_deltaPercent90_lte	int	百分比	90 天变化 %

2.5 COUNT_REFURBISHED — Refurbished Offer 数

参数	类型	取值	说明
COUNT_REFURBISHED_current_gte / COUNT_REFURBISHED_current_lte	int	≥ 0	当前 Refurbished Offer 数
COUNT_REFURBISHED_avg30_gte / COUNT_REFURBISHED_avg30_lte	int	≥ 0	30 天均值
COUNT_REFURBISHED_avg90_gte / COUNT_REFURBISHED_avg90_lte	int	≥ 0	90 天均值
COUNT_REFURBISHED_avg180_gte / COUNT_REFURBISHED_avg180_lte	int	≥ 0	180 天均值
COUNT_REFURBISHED_avg365_gte / COUNT_REFURBISHED_avg365_lte	int	≥ 0	365 天均值
COUNT_REFURBISHED_deltaPercent1_gte / COUNT_REFURBISHED_deltaPercent1_lte	int	百分比	1 天变化 %
COUNT_REFURBISHED_deltaPercent7_gte / COUNT_REFURBISHED_deltaPercent7_lte	int	百分比	7 天变化 %
COUNT_REFURBISHED_deltaPercent30_gte / COUNT_REFURBISHED_deltaPercent30_lte	int	百分比	30 天变化 %
COUNT_REFURBISHED_deltaPercent90_gte / COUNT_REFURBISHED_deltaPercent90_lte	int	百分比	90 天变化 %

2.6 COUNT_COLLECTIBLE — Collectible Offer 数

参数	类型	取值	说明
COUNT_COLLECTIBLE_current_gte / COUNT_COLLECTIBLE_current_lte	int	≥ 0	当前 Collectible Offer 数
COUNT_COLLECTIBLE_avg30_gte / COUNT_COLLECTIBLE_avg30_lte	int	≥ 0	30 天均值
COUNT_COLLECTIBLE_avg90_gte / COUNT_COLLECTIBLE_avg90_lte	int	≥ 0	90 天均值
COUNT_COLLECTIBLE_avg180_gte / COUNT_COLLECTIBLE_avg180_lte	int	≥ 0	180 天均值
COUNT_COLLECTIBLE_avg365_gte / COUNT_COLLECTIBLE_avg365_lte	int	≥ 0	365 天均值
COUNT_COLLECTIBLE_deltaPercent1_gte / COUNT_COLLECTIBLE_deltaPercent1_lte	int	百分比	1 天变化 %
COUNT_COLLECTIBLE_deltaPercent7_gte / COUNT_COLLECTIBLE_deltaPercent7_lte	int	百分比	7 天变化 %
COUNT_COLLECTIBLE_deltaPercent30_gte / COUNT_COLLECTIBLE_deltaPercent30_lte	int	百分比	30 天变化 %
COUNT_COLLECTIBLE_deltaPercent90_gte / COUNT_COLLECTIBLE_deltaPercent90_lte	int	百分比	90 天变化 %

2.7 totalOfferCount — 总 Offer 数

参数	类型	取值	说明
totalOfferCount_gte / totalOfferCount_lte	int	≥ 0	所有 Offer 总数

---

三、标题、分类与属性

3.1 文本输入

参数	类型	取值	说明
title	string	任意文本	标题关键词搜索
frequentlyBoughtTogetherFilter	string	ASIN	经常一起购买的 ASIN

3.2 分类

参数	类型	取值	说明
categories_include	array[int]	分类 ID 列表	包含的分类（任一匹配）
categories_exclude	array[int]	分类 ID 列表	排除的分类
rootCategory	array[int]	分类 ID 列表	根分类
classificationCategories	array[string]	分类路径字符串	分类路径

3.3 产品属性（autocomplete）

参数	类型	取值	说明
manufacturer	array[string]	字符串数组	制造商，如 ["canon"]；排除加 - 前缀
brand	array[string]	同上	品牌
brandStoreName	array[string]	同上	品牌店铺名称
brandStoreUrlName	array[string]	同上	品牌店铺 URL 名
model	array[string]	同上	型号
color	array[string]	同上	颜色
size	array[string]	同上	尺寸
edition	array[string]	同上	版本
format	array[string]	同上	格式
author	array[string]	同上	作者
binding	array[string]	同上	装订
languages	array[string]	同上	语言
scent	array[string]	同上	香味
itemForm	array[string]	同上	商品形态
pattern	array[string]	同上	图案
style	array[string]	同上	风格
material	array[string]	同上	材质
itemTypeKeyword	array[string]	同上	商品类型关键词
targetAudienceKeyword	array[string]	同上	目标受众关键词
type	array[string]	同上	类型
unitCount.unitType	array[string]	同上	单位类型
partNumber	array[string]	同上	零件号
buyBoxShippingCountry	array[string]	同上	Buy Box 发货国
salesRankDisplayGroup	array[string]	同上	Sales Rank 显示分组
websiteDisplayGroup	array[string]	同上	网站显示分组 ID
websiteDisplayGroupName	array[string]	同上	网站显示分组名称

排除模式：值前加 -。例 ["-canon"] = 排除 canon 品牌。 卖家 ID 筛选支持 isXOf 语义（isOneOf ~ is50Of），API 中由值的数量隐式表达。

---

四、Buy Box 状态（boolean）

不传 = 不过滤。true = Yes，false = No。

参数	类型	取值	说明
buyBoxIsFBA	boolean	true / false	Buy Box 是否 FBA
buyBoxIsPreorder	boolean	true / false	是否预售
buyBoxIsBackorder	boolean	true / false	是否缺货订购
buyBoxIsPrimeEligible	boolean	true / false	是否 Prime 合格
buyBoxIsPrimeExclusive	boolean	true / false	是否 Prime 专享
buyBoxIsUnqualified	boolean	true / false	Buy Box 是否不合格

---

五、Buy Box 统计

参数	类型	取值	说明
buyBoxStatsAmazon30_gte / buyBoxStatsAmazon30_lte	int	0–100	Amazon 占 Buy Box 比例 30天
buyBoxStatsAmazon90_gte / buyBoxStatsAmazon90_lte	int	0–100	90天
buyBoxStatsAmazon180_gte / buyBoxStatsAmazon180_lte	int	0–100	180天
buyBoxStatsAmazon365_gte / buyBoxStatsAmazon365_lte	int	0–100	365天
buyBoxStatsSellerCount30_gte / buyBoxStatsSellerCount30_lte	int	≥ 0	Buy Box 卖家数 30天
buyBoxStatsSellerCount90_gte / buyBoxStatsSellerCount90_lte	int	≥ 0	90天
buyBoxStatsSellerCount180_gte / buyBoxStatsSellerCount180_lte	int	≥ 0	180天
buyBoxStatsSellerCount365_gte / buyBoxStatsSellerCount365_lte	int	≥ 0	365天
buyBoxStatsTopSeller30_gte / buyBoxStatsTopSeller30_lte	int	0–100	Top Seller 占比 % 30天
buyBoxStatsTopSeller90_gte / buyBoxStatsTopSeller90_lte	int	0–100	90天
buyBoxStatsTopSeller180_gte / buyBoxStatsTopSeller180_lte	int	0–100	180天
buyBoxStatsTopSeller365_gte / buyBoxStatsTopSeller365_lte	int	0–100	365天
buyBoxStandardDeviation30_gte / buyBoxStandardDeviation30_lte	int	≥ 0	价格标准差 30天
buyBoxStandardDeviation90_gte / buyBoxStandardDeviation90_lte	int	≥ 0	90天
buyBoxStandardDeviation365_gte / buyBoxStandardDeviation365_lte	int	≥ 0	365天
buyBoxEligibleOfferCounts.0_gte / buyBoxEligibleOfferCounts.0_lte	int	≥ 0	0竞争者Offer数
buyBoxEligibleOfferCounts.1_gte / buyBoxEligibleOfferCounts.1_lte	int	≥ 0	1竞争者
buyBoxEligibleOfferCounts.2_gte / buyBoxEligibleOfferCounts.2_lte	int	≥ 0	2竞争者
buyBoxEligibleOfferCounts.3_gte / buyBoxEligibleOfferCounts.3_lte	int	≥ 0	3竞争者
availabilityAmazonDelay_gte / availabilityAmazonDelay_lte	int	≥ 0	Amazon 发货延迟天数
outOfStockCountAmazon30_gte / outOfStockCountAmazon30_lte	int	≥ 0	Amazon 缺货次数 30天
outOfStockCountAmazon90_gte / outOfStockCountAmazon90_lte	int	≥ 0	90天
buyBoxStatsTopSellerId30	string	Seller ID	30天 Top Seller ID
buyBoxStatsTopSellerId90	string	Seller ID	90天
buyBoxStatsTopSellerId180	string	Seller ID	180天
buyBoxStatsTopSellerId365	string	Seller ID	365天

---

六、库存状态 availabilityAmazon（多选，整数数组）

取值	含义
-1	无 Amazon Offer
0	Amazon 有货可发
1	Amazon 预售
2	Amazon 库存未知
3	Amazon 缺货订购中
4	Amazon 发货延迟

例："availabilityAmazon": [-1, 0] — 无 Amazon offer 或 Amazon 有货。

---

七、卖家 ID

buyBoxSellerIdHistory

直接传卖家 ID 数组。加 - 前缀 = 排除该卖家。

场景	实际 API 值
仅 Amazon（含自营 + Warehouse）	["ATVPDKIKX0DER", "A3SLTBYT1P4ASM"]
排除 Amazon（仅第三方）	["-ATVPDKIKX0DER", "-A3SLTBYT1P4ASM"]
仅某指定卖家	["SELLER_ID"]
排除某卖家	["-SELLER_ID"]

其他卖家筛选字段

参数	类型	取值	说明
sellerIds	array[string]	Seller ID 列表	按卖家 ID 筛选
sellerIdsFBA	array[string]	同上	按 FBA 卖家筛选
sellerIdsFBM	array[string]	同上	按 FBM 卖家筛选
sellerIdsLowestFBA	array[string]	同上	最低 FBA 价卖家
sellerIdsLowestFBM	array[string]	同上	最低 FBM 价卖家

各站点 Amazon 自营 + Warehouse Deals Seller ID

Keepa 中选 "Amazon" 同时包含自营和 Warehouse Deals 两个 ID。

Domain	站点	Amazon 自营	Warehouse Deals
1	US (.com)	ATVPDKIKX0DER	A3SLTBYT1P4ASM
2	UK (.co.uk)	A3P5ROKL5A1OLE	A2OAJ7377I5K2J
3	DE (.de)	A3JWKAKR8XB7XF	A2OAJ7377I5K2J
4	FR (.fr)	A1X6FK5RDHNB96	A2OAJ7377I5K2J
5	JP (.co.jp)	A3G29N9OAI9R3V	—
6	CA (.ca)	A3DWYIK6Y9EEQB	A2XH5F5Y3M5J1B
8	IT (.it)	A3KNG56F5WZR3M	A2OAJ7377I5K2J
9	ES (.es)	A1RKKUPIHCS9HS	A2OAJ7377I5K2J
10	IN (.in)	A14UQ4H6LWPSYY	—
11	MX (.com.mx)	A1AM78C64UM0Y8	—
12	BR (.com.br)	A3RN42UQ4F2RPD	—

EU 站点（UK/DE/FR/IT/ES）共享同一个 Warehouse ID。

---

八、Buy Box Used

参数	类型	取值	说明
buyBoxUsed.isFBA	boolean	true / false	Buy Box Used 是否 FBA（不传=不过滤）
buyBoxUsed.condition	array[int]	2 = Like New / 3 = Very Good / 4 = Good / 5 = Acceptable	成色（可多选）
buyBoxUsed.seller	string	同 buyBoxSellerIdHistory 格式	卖家 ID（- 排除）

---

九、产品属性（boolean）

不传 = 不过滤。true = Yes，false = No。

参数	类型	取值	说明
isAdultProduct	boolean	true / false	是否成人用品
isEligibleForTradeIn	boolean	true / false	是否支持 Trade-In
hasAPlus	boolean	true / false	是否有 A+ 内容
hasAPlusFromManufacturer	boolean	true / false	A+ 是否来自制造商
hasMainVideo	boolean	true / false	是否有主视频
hasParentASIN	boolean	true / false	是否有父 ASIN（变体）
isAmazonRenewed	boolean	true / false	是否 Amazon Renewed
isHazMat	boolean	true / false	是否危险品
isHeatSensitive	boolean	true / false	是否热敏品
isMerchOnDemand	boolean	true / false	是否按需印刷
isSNS	boolean	true / false	是否 SNS
batteriesIncluded	boolean	true / false	是否含电池
batteriesRequired	boolean	true / false	是否需要电池

---

十、产品类型 & 退货率

参数	类型	取值	说明
productType	array[int]	0 = Physical Product / 1 = Digital Product / 2 = eBooks	产品类型（可多选）
returnRate	array[int]	1 = Low / 2 = High	退货率（可多选）

---

十一、Deal 类型

参数	类型	取值	说明
dealType	array[string]	app_only	仅 App
		clearance_no_returns	清仓不可退
		countdown_ends_in	倒计时
		early_access_with_prime	Prime 抢先
		generic_offer_promo	通用促销
		limited_time_deal	限时 Deal
		prime_day	Prime Day
		prime_day_early	Prime Day 提前
		prime_exclusive	Prime 专享
		prime_selling_fast	Prime 热销
		selling_fast	热销中
		special_event_sale	特殊活动
		unknown	未知类型

---

十二、数值筛选项

参数	类型	取值	说明
monthlySold_gte / monthlySold_lte	int	≥ 0	月销量
monthlySoldLastKnown_gte / monthlySoldLastKnown_lte	int	≥ 0	最近已知月销量
monthlySoldPeak_gte / monthlySoldPeak_lte	int	≥ 0	历史峰值月销量
deltaPercent90_monthlySold_gte / deltaPercent90_monthlySold_lte	int	百分比	90天月销量变化 %
salesRankDrops30_gte / salesRankDrops30_lte	int	≥ 0	30天排名下降次数
salesRankDrops90_gte / salesRankDrops90_lte	int	≥ 0	90天
salesRankDrops180_gte / salesRankDrops180_lte	int	≥ 0	180天
salesRankDrops365_gte / salesRankDrops365_lte	int	≥ 0	365天
srAvg_gte / srAvg_lte	int	≥ 1	平均 Sales Rank
RATING_current_gte / RATING_current_lte	int	×10，如 45=4.5星	评分
reviews.reviewCount_gte / reviews.reviewCount_lte	int	≥ 0	评论总数
COUNT_REVIEWS_current_gte / COUNT_REVIEWS_current_lte	int	≥ 0	评论数（也支持 avg30/90/180/365）
couponOneTimeAbsolute_gte / couponOneTimeAbsolute_lte	int	cents	一次性优惠券绝对值
couponOneTimePercent_gte / couponOneTimePercent_lte	int	%	一次性优惠券 %
couponSNSPercent_gte / couponSNSPercent_lte	int	%	SNS 优惠券 %
businessDiscount_gte / businessDiscount_lte	int	%	企业折扣
fbaFees_gte / fbaFees_lte	int	cents	FBA 费用
classificationRank_gte / classificationRank_lte	int	≥ 1	分类排名
imageCount_gte / imageCount_lte	int	≥ 0	图片数量
variationCount_gte / variationCount_lte	int	≥ 0	变体数量
videoCount_gte / videoCount_lte	int	≥ 0	视频数量
flipability30_gte / flipability30_lte	int		30天翻卖指数
flipability90_gte / flipability90_lte	int		90天
flipability365_gte / flipability365_lte	int		365天

---

十三、尺寸与重量

参数	类型	取值	说明
itemLength_gte / itemLength_lte	int	cm	商品长度
itemWidth_gte / itemWidth_lte	int	cm	商品宽度
itemHeight_gte / itemHeight_lte	int	cm	商品高度
itemDimension_gte / itemDimension_lte	int	cm³	商品体积
itemWeight_gte / itemWeight_lte	int	g	商品重量
packageLength_gte / packageLength_lte	int	cm	包装长度
packageWidth_gte / packageWidth_lte	int	cm	包装宽度
packageHeight_gte / packageHeight_lte	int	cm	包装高度
packageDimension_gte / packageDimension_lte	int	cm³	包装体积
packageWeight_gte / packageWeight_lte	int	g	包装重量
numberOfItems_gte / numberOfItems_lte	int	≥ 1	商品件数
numberOfPages_gte / numberOfPages_lte	int	≥ 0	页数

---

十四、日期范围

参数	类型	取值	说明
trackingSince_from / trackingSince_to	KeepaTime	毫秒时间戳	追踪起始时间
listedSince_from / listedSince_to	KeepaTime	毫秒时间戳	上架时间
releaseDate_from / releaseDate_to	KeepaTime	毫秒时间戳	发布日期
publicationDate_from / publicationDate_to	KeepaTime	毫秒时间戳	出版日期
lastPriceChange_from / lastPriceChange_to	KeepaTime	毫秒时间戳	最后价格变动
monthlySoldLastKnownDate_from / monthlySoldLastKnownDate_to	KeepaTime	毫秒时间戳	最近已知月销量日期
monthlySoldPeakDate_from / monthlySoldPeakDate_to	KeepaTime	毫秒时间戳	峰值月销量日期

KeepaTime 换算公式：

unixMs  = (keepaTime + 21564000) × 60000
keepaTime = unixMs ÷ 60000 − 21564000

也可用 keepa_time_convert 工具互转。

---

十五、其他

参数	类型	取值	说明
srAvgMonth	int	YYYYMM，如 202604	Sales Rank 平均月份
singleVariation	boolean	true / false	每个产品仅显示一个变体
allowOutdatedOfferData	boolean	true / false	允许可能过时的价格信息

---

十六、Sort（排序）

"sort": [["{FIELD}", "asc"|"desc"], ...]

支持多级排序。示例（先按 Sales Rank 升序，再按月销量降序）：

"sort": [
    ["current_SALES", "asc"],
    ["monthlySold", "desc"]
]

常用字段：

• current_SALES、current_RATING、current_COUNT_REVIEWS
• 任何 {TYPE}_{PERIOD} 组合（如一、二节中的 gte/lte 对应去后缀的基础字段）
• monthlySold、salesRankDrops30、trackingSince

---

十七、互斥条件

1. isLowest / isLowest90：勾选后同 TYPE 的价格范围无效（锁定最低价）
2. productType：选 1(Digital) 或 2(eBooks) 时，尺寸重量等物理属性不适用
3. seller ID：- 前缀 = 排除该卖家
4. autocomplete 排除：值前加 - 前缀切换为排除模式

---

十八、完整示例

{
  "domain": 1,
  "page": 0,
  "perPage": 50,
  "sort": [["current_SALES", "asc"]],
  "title": "",
  "categories_include": [],
  "rootCategory": [],
  "brand": ["canon"],
  "productType": [0],
  "BUY_BOX_SHIPPING_current_gte": 1000,
  "BUY_BOX_SHIPPING_current_lte": 5000,
  "BUY_BOX_SHIPPING_isLowest": false,
  "SALES_current_gte": 1,
  "SALES_current_lte": 100000,
  "RATING_current_gte": 40,
  "monthlySold_gte": 100,
  "buyBoxIsFBA": true,
  "isAdultProduct": false,
  "salesRankDrops30_gte": 5,
  "availabilityAmazon": [0],
  "dealType": ["limited_time_deal"],
  "itemWeight_lte": 1000,
  "buyBoxSellerIdHistory": ["-ATVPDKIKX0DER"],
  "stats": 1
}

---

相关链接

• keepa_product_finder MCP 工具
• HTTP API ProductFinder
• Product Object 字段速查