addBsr100Task：BSR 榜单采集接口
提交 BSR 畅销榜（Best Sellers）或新品榜（New Releases）的完整链接，采集该榜单前 100 名商品 ASIN 列表。
POST
https://ksicdata.com/api/addBsr100Task
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
suffixUrl | string | 是 | 榜单页完整 URL（需带域名），问号 ? 之后的参数会被去除 |
type | string | 是 | 榜单类型：1 = BSR 畅销榜，2 = New Releases 新品榜 |
region | string | 是 | 站点代码，例如 us，取值见支持站点 |
zipCode | string | 是 | 收货邮编，必填，用于模拟本地配送地址 |
请求示例
JSON
[
{
"suffixUrl": "https://www.amazon.com/gp/new-releases/baby-products/166863011/ref=zg_bsnr_pg_2_baby-products?ie=UTF8&pg=2",
"region": "us",
"zipCode": "10001",
"type": "2"
}
]curl 示例 （点击展开）
cURL
curl -X POST "https://ksicdata.com/api/addBsr100Task" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"suffixUrl": "https://www.amazon.com/gp/new-releases/baby-products/166863011/ref=zg_bsnr_pg_2_baby-products?ie=UTF8&pg=2",
"region": "us",
"zipCode": "10001",
"type": "2"
}
]'响应示例
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}采集数据示例 （点击展开）
JSON
{
"asins": [
"B0H7J36CWB", "B0HGFSZ1NF", "B0GQS8C35N", "B0HBLYJ8QS", "B0H6L2CC95",
"B0H947W4TN", "B0H6SHHJ2K", "B0HB3VVH2D", "B0H9YN1T4V", "B0H6WKFYBL"
],
"page": 2,
"region": "us",
"type": "NEW_RELEASE_TOP100",
"url": "https://www.amazon.com/gp/new-releases/baby-products/166863011/ref=zg_bsnr_pg_2_baby-products"
}返回字段
| 字段 | 名称 | 类型 | 说明 |
|---|---|---|---|
asins | ASIN 列表 | List<String> | 页面采集到的 asin，顺序即排名顺序；第二页则从第 51 名开始 |
page | 页码 | Integer | 1 或 2 |
region | 国家 | String | 站点代码，如 us |
type | 榜单类型 | String | NEW_RELEASE_TOP100 或 BSR_TOP100 |
url | 榜单链接 | String | 回传用户传入的 url（问号后的参数已去除），方便判断任务来源 |
所有接口均以 https://ksicdata.com/api 为前缀，POST 提交 JSON 数组，通过 ks-token 认证；单次最多 2000 条。
常见问题
suffixUrl 要传完整 URL 吗？
需要带域名的完整链接；URL 中问号 ? 之后的参数会被服务端自动去除。
type 应该传什么？
BSR 畅销榜传 1，New Releases 新品榜传 2。
第二页怎么采？
在 suffixUrl 中使用榜单第二页的链接（含 pg=2），返回的 asins 即第 51-100 名，page 字段为 2。
榜单链接示例？
如 https://www.amazon.com/Best-Sellers-Baby-Baby-Care-Products/zgbs/baby-products/17720255011/ref=zg_bs_nav_baby-products_1 。
