keepa_get_seller

查询 Amazon 卖家信息。对应 Keepa /seller 接口。

用途

• 按 Seller ID 批量查询卖家基本信息（名称、评分、国家等）
• 拉取某个卖家的店铺 ASIN 列表（需 storefront: true）
• 可选返回 csv 时间序列（评分/反馈数历史）

参数

名称	类型	必填	默认	约束	说明
country	enum	✅	—	—	Amazon 站点代码
seller	string[]	✅	—	1–100	卖家 ID 列表。⚠️ 单次最多 100 个，超过请分批；storefront=true 时仅支持 1 个
storefront	boolean		false	—	是否拉取店铺 ASIN 列表
update	integer		—	≥ 0	storefront 数据新鲜度（小时）
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）

使用示例

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

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

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

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

返回结构

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

和 HTTP API 的对应

• HTTP：GET /api/keepa/seller
• 返回的每个卖家对象的完整字段（评分四元组、csv 双索引、Storefront 字段、类目品牌竞品 / Buy Box 占有率等）见 Seller Object