Search Insights Object

searchInsights 是 Product Finder 的统计聚合子对象，把命中的几百到上百万个 ASIN 预聚合成一组可直接用作 KPI 的指标——平均 Buy Box 价、卖家 / 品牌分布、FBA 占比、评分分布等，不用 你再把全部 ASIN 拉回来自己算。

对应 Keepa 官方：Search Insights Object

何时返回

条件	Keepa 上游	Keepamore 响应	计费
Product Finder 调用时 selection 带 "stats": 1	✅ 返回 searchInsights	✅ data.searchInsights 透传完整对象	+30 units（叠加在基础 1 unit 上）
未带 stats=1	❌	data.searchInsights = null	仅基础 1 unit

🛠 Keepamore 计费规则：stats=1 会让上游 Keepa 多算一笔聚合，按官方计费在基础 1 unit 之上额外扣 30 units。详见 productfinder 端点 · 计费。

响应示例

{
	"data": {
		"asinList": ["B0...", "B0..."],
		"totalResultCount": 12345,
		"searchInsights": {
			"avgBuyBox": 6711,
			"avgRating": 45,
			"avgReviewCount": 1287,
			"isFBAPercent": 78.3,
			"soldByAmazonPercent": 12.4,
			"hasCouponPercent": 5.1,
			"sellerCount": 932,
			"brandCount": 217,
			"topBrandsWithCounts": { "Anker": 84, "Logitech": 51 },
			"topSellersWithCounts": { "A2L77EE7U53NWQ": 312 }
		},
		"fromCache": false
	}
}

字段表

字段	类型	说明
avgDeltaPercent30BuyBox avgDeltaPercent90BuyBox avgDeltaPercent30Amazon avgDeltaPercent90Amazon	float	命中产品过去 30 / 90 天 Buy Box / Amazon 价的平均涨跌百分比。每个产品权重相同（不按价格加权）。正值 = 整体变便宜；负值 = 整体涨价。例：-0.12 = -0.12%
avgBuyBox avgBuyBox90 avgBuyBox365	int	命中产品的当前 / 近 90 天 / 近 365 天 Buy Box 价的平均值（cents）。按价格加权——高价品权重更大。例：6711 = €67.11
avgBuyBoxDeviation	int	命中产品近 30 天 Buy Box 价的平均偏差（cents），衡量短期价格波动
avgReviewCount	int	命中产品的平均评论数
avgRating	int	命中产品的平均评分（× 10）。例：45 = 4.5 星。详见 评分单位
isFBAPercent	float	当前 Buy Box offer 为 FBA 的产品占比，0.0–100.0。例：78.3 = 78.3%
soldByAmazonPercent	float	当前由 Amazon 自营的产品占比
hasCouponPercent	float	当前有 active 优惠券的产品占比
avgOfferCountNew	float	平均每个产品的 New offer 数（不含缺货 offer）
avgOfferCountUsed	float	平均每个产品的 Used offer 数（不含缺货 offer）
sellerCount	int	结果集中至少有一个 live offer 的不同卖家总数
brandCount	int	结果集中不同品牌总数
highestRank	int	命中产品中最差（数值最大）的 Sales Rank
lowestRank	int	命中产品中最好（数值最小）的 Sales Rank
relatedCategories	long[]	与命中产品高度相关的分类 ID 列表（可传给 /keepa/category 拉详情）
topBrandsWithCounts	Map<string, int>	出现次数最多的最多 5 个品牌及其产品计数。Key = 品牌名；按计数降序
topSellersWithCounts	Map<string, int>	Buy Box 占比最高的最多 5 个卖家 ID 及其出现计数。Key = sellerId，可传给 /keepa/seller 拉卖家详情；按计数降序

加权 vs 等权一览

不同字段的统计方式不一致，使用前注意：

类型	字段示例	说明
等权（每个 ASIN 权重相同）	avgDeltaPercent30BuyBox 等 4 个 deltaPercent 字段	反映「典型产品」涨跌幅；不会被极端高价品拉偏
价格加权（高价品权重更大）	avgBuyBox / avgBuyBox90 / avgBuyBox365	反映该结果集的价值中心；适合算 GMV / 库存价值
占比型（0.0–100.0）	isFBAPercent / soldByAmazonPercent / hasCouponPercent	直接是百分比数值，不是 0–1

上层 / 关联对象

• 上层接口：Product Finder（data.searchInsights）
• 关联端点：/keepa/seller（解析 topSellersWithCounts）/ /keepa/category（解析 relatedCategories）
• 公共约定：字段速查 · 公共约定（cents / 评分 ×10）