addSellerAsinTask:店铺 ASIN 列表采集接口
提交卖家 ID,采集该店铺下的商品 ASIN 列表,按页面展示顺序返回——越靠前上架日期越新,非常适合做店铺上新监控。
POST
https://ksicdata.com/api/addSellerAsinTask
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sellerId | string | 是 | 卖家 ID,例如 A2RJLAGU2HCBYM |
page | integer | 否 | 抓取页数,不填则抓取该店铺下的所有 ASIN,最多 1000 页 |
region | string | 是 | 站点代码,例如 us,取值见支持站点 |
zipCode | string | 是 | 收货邮编,必填,用于模拟本地配送地址 |
请求示例
JSON
[
{
"sellerId": "A2RJLAGU2HCBYM",
"region": "us",
"zipCode": "10001"
}
]
curl 示例 (点击展开)
cURL
curl -X POST "https://ksicdata.com/api/addSellerAsinTask" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"sellerId": "A2RJLAGU2HCBYM",
"region": "us",
"zipCode": "10001"
}
]'
响应示例
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}
采集数据示例 (点击展开)
JSON
{
"asins": [
"B0GHR4CFKQ", "B0GGQHMM1K", "B0GGQQ5BJQ", "B0GFCWM8Q9",
"B0FZKR62Y4", "B0FSJP3H7V", "B0FQBNJC51", "B0FQBLKYM4"
],
"page": 2,
"region": "us",
"sellerId": "A2RJLAGU2HCBYM",
"userId": "1"
}
返回字段
| 字段 | 名称 | 类型 | 说明 |
|---|---|---|---|
asins | ASIN 列表 | List<String> | 页面采集到的 asin,顺序为页面展示顺序,越靠前上架日期越新 |
page | 页码 | Integer | 页码 |
region | 国家 | String | 站点代码,如 us |
sellerId | 卖家 ID | String | 卖家 id |
所有接口均以 https://ksicdata.com/api 为前缀,POST 提交 JSON 数组,通过 ks-token 认证;单次最多 2000 条。
常见问题
page 不填会怎样?
不填时抓取该店铺下的所有 ASIN,最多 1000 页。
怎么用它做上新监控?
按天采集同一店铺的 ASIN 列表并做差集对比,新增的 ASIN 即为新上架商品。
返回顺序代表什么?
顺序为页面展示顺序,越靠前的商品上架日期越新。
和 addSellerTask 有什么区别?
addSellerTask 返回店铺信息(评分、地址等),addSellerAsinTask 返回店铺下的 ASIN 列表。