kmore_get_top_sellers

获取指定站点的 Most Rated Sellers（评价数最多的卖家）榜单，数据来自我们的每日全量快照（每天 02:00 同步，零延迟）。

用途

• 快速扫描某站点评价数最多的头部卖家
• 做竞品卖家调研的起点
• 查历史榜单（date 参数）：任意一天的排名、对比不同日期的进出榜变化
• 直接拿详情（detail=true）：一步拿到评分分布 / BuyBox 占有率 / 类目品牌统计 / 竞争对手等全字段，无需再调 kmore_get_seller

参数

名称	类型	必填	默认	约束	说明
country	enum	✅	—	—	Amazon 站点代码
date	string		—	日期格式	快照日期 YYYY-MM-DD（查历史榜单）。不传 = 最新快照日期。历史自 2026-06 起
detail	boolean		false	—	true 返回全字段详情（45 列，见下）；只查 ID 不用传
page	integer	✅	0	≥ 0	0-indexed 页码
perPage	integer	✅	1000	1–10000	每页条目数；detail=true 时上限 1000

计费

响应形态	units / 次
只返回卖家 ID 列表（默认）	20
detail=true（含全字段详情）	50

使用示例

// 最新榜单前 100 名（只要 ID）
{ "country": "us", "page": 0, "perPage": 100 }

// 查 2026-09-01 的历史榜单
{ "country": "us", "date": "2026-09-01", "page": 0, "perPage": 100 }

// 直接拿前 50 名的全字段详情
{ "country": "us", "detail": true, "page": 0, "perPage": 50 }

返回结构

默认（ID 列表）：

{
	"success": true,
	"data": {
		"sellerIdList": ["A1PA6795UKMFR9", "ATVPDKIKX0DER", "..."],
		"_pagination": {
			"page": 0,
			"perPage": 100,
			"total": 10000,
			"totalPages": 100
		},
		"_snapshot": { "date": "2026-10-03", "source": "snapshot" },
		"fromCache": false
	}
}

• sellerIdList：当前页的 Seller ID 数组（rank 升序 = 评价数排名）
• _pagination：🛠 Keepamore 在上游全量返回基础上做的服务端切片元信息；total 为切片前完整列表长度
• _snapshot：source: "snapshot" = 来自每日快照（含 date）；快照整体不可用时自动回退实时接口（此时无 _snapshot 字段）

detail=true（全字段详情）：在上述字段外增加 sellers 数组（与 sellerIdList 同序），每行 45 列快照字段（snake_case）：

字段组	字段
标识/排名	country seller_id rank_position seller_name business_name domain_id
地址	address_line1 city state zip_code seller_country_code phone_number
评分	current_rating（0-100 好评率）current_rating_count（终身评分数）ratings_last_30_days；rating_{30d|90d|365d}_{count|positive|neutral|negative}（12 列分时段分布）
BuyBox	buy_box_new_rate buy_box_used_rate（占有率 0-100）avg_buy_box_competitors
店铺	has_fba ships_from_china storefront_asin_count（在售 ASIN 数）
类目/品牌	primary_category_id primary_category_name primary_brand_name；category_statistics brand_statistics（完整分布数组，已 JSON 解析）
竞争对手	competitors_json（[{percent, sellerId}]，已 JSON 解析）
时间	tracked_since last_update last_rating_update（毫秒）；recent_feedback（最近评价）；snapshot_date

detail=true 时 sellerIdList 是当页的 ID（不全量下发），全量看 _pagination.total。

历史覆盖范围

• 时间：2026-06 起至今（每天一份全量，北京时间 02:00 后可查当天）
• 范围：每站点 Top 100,000 名内卖家（Most Rated Sellers 榜单全量）
• 指定日期无快照时报错并列出该站点可用日期范围；不带 date 且快照整体不可用时自动回退实时接口（仅 ID 列表形态）

和 HTTP API 的对应

• HTTP：GET /api/topseller