kmore_get_seller

查询 Amazon 卖家信息；带 date 参数时切换为 历史快照模式（查任意一天的卖家档案）。

用途

• 按 Seller ID 批量查询卖家基本信息（名称、评分、国家等）
• 拉取某个卖家的店铺 ASIN 列表（需 storefront: true）
• 可选返回 csv 时间序列（评分/反馈数历史）
• 查历史（date 参数）：某卖家在任意过去一天的名次、评分分布、类目品牌统计等

参数

名称	类型	必填	默认	约束	说明
country	enum	✅	—	—	Amazon 站点代码
seller	string[]	✅	—	1–100	卖家 ID 列表。⚠️ 单次最多 100 个，超过请分批；storefront=true 时仅支持 1 个
storefront	boolean		false	—	是否拉取店铺 ASIN 列表（与 date 互斥）
update	integer		—	≥ 0	storefront 数据新鲜度（小时）；与 date 互斥
date	string		—	日期格式	历史快照模式：查该日（YYYY-MM-DD）的卖家快照。⚠️ 只覆盖每站点 Top 100,000 名内卖家（不在榜内的 ID 进 missing）；响应为快照 45 列字段形态（见下）；自 2026-06 起
page	integer	✅	0	≥ 0	storefront asinList 分页
perPage	integer	✅	1000	1–10000	每页条目数
csvDays	integer		0	≥ -1	csv 时间序列控制：0 = 不返回（默认，节省上下文）；>0 = 只返回最近 N 天；-1 = 返回全部

计费

• storefront: false：N units / 次（N = seller 数组去重后的数量）
• storefront: true：10 units / 次（且仅支持 1 个 seller ID）
• 带 date（历史快照）：计费不变，N units / 次

使用示例

批量查 3 个卖家的基础信息：

{
	"country": "us",
	"seller": ["A1PA6795UKMFR9", "ATVPDKIKX0DER", "A2Z7Z7Z7Z7Z7Z7"],
	"page": 0,
	"perPage": 100
}

拉某卖家的店铺前 200 个 ASIN：

{
	"country": "us",
	"seller": ["A1PA6795UKMFR9"],
	"storefront": true,
	"page": 0,
	"perPage": 200
}

查 2 个卖家在 2026-09-01 的历史档案：

{
	"country": "us",
	"seller": ["A1PA6795UKMFR9", "ATVPDKIKX0DER"],
	"date": "2026-09-01",
	"page": 0,
	"perPage": 100
}

返回结构

实时模式（默认）：

{
	"code": "0000",
	"data": {
		"country": "us",
		"sellers": [
			{
				"sellerId": "A1PA6795UKMFR9",
				"sellerName": "...",
				"rating": 95,
				"totalFeedbackCount": 123456,
				"asinList": ["B0..."]
			}
		],
		"page": 0,
		"perPage": 1000
	}
}

历史快照模式（带 date）：sellers 变为以卖家 ID 为键的对象表，每行是快照 45 列字段（snake_case：rank_position 当日名次、current_rating 好评率、rating_{30d|90d|365d}_{count|positive|neutral|negative} 分时段评分分布、buy_box_new_rate、has_fba、storefront_asin_count、primary_category_name、category_statistics / brand_statistics / competitors_json（已解析为数组/对象）、snapshot_date 等，完整字段表见 get-top-sellers 的 detail 说明）；不在 Top 10 万内的 ID 列在 missing 数组。

和 HTTP API 的对应

• HTTP：GET /api/seller（历史快照模式详见该页 date 专节）
• 返回的每个卖家对象的完整字段（评分四元组、csv 双索引、Storefront 字段、类目品牌竞品 / Buy Box 占有率等）见 Seller Object（实时模式）