addCategory400Task：类目前 400 采集接口
提交类目节点 ID，采集该节点下榜单页面的 ASIN 列表，最多 400 页，用于批量发现同赛道商品。
POST
https://ksicdata.com/api/addCategory400Task
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
nodeId | string | 是 | 类目节点 ID，例如 17720255011 |
page | integer | 否 | 抓取页数，最大 400，不填默认 400 |
region | string | 是 | 站点代码，例如 us，取值见支持站点 |
zipCode | string | 是 | 收货邮编，必填，用于模拟本地配送地址 |
请求示例
JSON
[
{
"nodeId": "17720255011",
"page": 400,
"region": "us",
"zipCode": "10001"
}
]curl 示例 （点击展开）
cURL
curl -X POST "https://ksicdata.com/api/addCategory400Task" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"nodeId": "17720255011",
"page": 400,
"region": "us",
"zipCode": "10001"
}
]'响应示例
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}采集数据示例 （点击展开）
JSON
{
"asins": [
"B0D14Y57K7", "B0DKKVRHK9", "B0DPNC61JZ", "B0CH1NYCV1",
"B0DYTZP95B", "B0CB5BX8JK", "B0CSTFLRK4", "B0D2JL223K"
],
"nodeId": "17720255011",
"page": 5,
"region": "us",
"type": "BSR"
}返回字段
| 字段 | 名称 | 类型 | 说明 |
|---|---|---|---|
asins | ASIN 列表 | List<String> | 页面采集到的 asin，顺序为页面 asin 展示的顺序 |
page | 页码 | Integer | 1 ~ 400 |
nodeId | 类目节点 ID | String | 传入的 nodeId |
region | 国家 | String | 站点代码，如 us |
type | 榜单类型 | String | 固定为 BSR |
所有接口均以 https://ksicdata.com/api 为前缀，POST 提交 JSON 数组，通过 ks-token 认证；单次最多 2000 条。
常见问题
page 不传会怎样？
page 为可选参数，不传时默认抓取 400 页，最大值为 400。
nodeId 从哪里获取？
nodeId 是 Amazon 类目节点 ID，可从类目页面 URL 中获取，例如 /zgbs/baby-products/17720255011/ 中的 17720255011。
返回的是商品详情吗？
不是。该接口返回类目榜单中的 ASIN 列表，如需详情数据可再用 addAsinTask 批量采集。
type 字段是什么？
固定为 BSR，表示数据来自类目榜单。
