addAsinTask：ASIN 商品详情采集接口
提交 ASIN 列表，异步采集对应商品详情页数据，返回标题、价格、评分、评论数、BSR 排名、变体、图文描述等字段。
POST
https://ksicdata.com/api/addAsinTask
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
asin | string | 是 | ASIN 编码，例如 B0CB3TJ46F |
region | string | 是 | 站点代码，例如 us，取值见支持站点 |
zipCode | string | 是 | 收货邮编，必填，用于模拟本地配送地址 |
请求示例
JSON
[
{
"asin": "B0CB3TJ46F",
"region": "us",
"zipCode": "10001"
}
]curl 示例 （点击展开）
cURL
curl -X POST "https://ksicdata.com/api/addAsinTask" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"asin": "B0CB3TJ46F",
"region": "us",
"zipCode": "10001"
}
]'响应示例
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}采集数据示例 （点击展开）
JSON
{
"asin": "B0CB3TJ46F",
"parentAsin": "B0CJDQJCJV",
"brandName": "Fitede",
"ratings": 4.4,
"reviews": 429,
"title": "RE0F10A RE0F10B JF011E Transmission Filter Oil Pan Gasket Kit 31728-1XF02",
"subTitle": "Stainless Steel Wire Skimmer Spoon with Long Handle Asian Work Strainer Ladle for Kitchen Cooking and Frying",
"bundleItems": ["B0CQ7WZBJ2", "B09M8NTXMG"],
"price": 16.49,
"buybox": 16.49,
"currency": "$",
"bs": false,
"ac": true,
"newReleases": false,
"newOnAmz": false,
"mainRank": { "rank": 46987, "rankName": "Automotive" },
"nodeNames": ["Automotive", "Replacement Parts", "Filters"],
"sellerId": "A32T2X8A81QU4X",
"sellerName": "FTDFITS",
"sellerType": "FBA",
"stockState": 1,
"stockStr": "In Stock",
"bought": "100+ bought",
"date": 1788933552498,
"taskAsin": "B0CB3TJ46F"
}返回字段
完整字段说明（含截图）见 API 参考附录中的 ASIN 采集字段说明，共 58 个字段。
查看完整字段说明（含截图）所有接口均以 https://ksicdata.com/api 为前缀，POST 提交 JSON 数组，通过 ks-token 认证；单次最多 2000 条。
常见问题
单次可以提交多少个 ASIN？
请求体为 JSON 数组，单次最多 2000 条，超出会返回 10002 错误。
zipCode 是必填的吗？
是。zipCode 用于模拟当地配送地址，价格、运费与库存会按该邮编的实际展示结果返回。
返回的 asin 和提交的 asin 不一致？
当页面发生跳转时，asin 字段会以页面实际展示的 ASIN（currentAsin）为准，同时 taskAsin 保留你提交的原始 ASIN，便于对账。
userId 需要传吗？
不需要。服务端会根据 ks-token 自动解析用户身份，请求体中无需传入 userId。
