addKeywordTask：关键词搜索数据采集接口
提交关键词，采集搜索结果页前 3 页数据，返回每个 ASIN 的展示顺序与位置类型（SP 广告 / Amazon’s Choice / Best Seller / 自然位）。
POST
https://ksicdata.com/api/addKeywordTask
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | string | 是 | 搜索关键词，例如 ssd，长度需小于 200 |
region | string | 是 | 站点代码，例如 us，取值见支持站点 |
zipCode | string | 是 | 收货邮编，必填，用于模拟本地配送地址 |
请求示例
JSON
[
{
"keyword": "ssd",
"region": "us",
"zipCode": "10001"
}
]curl 示例 （点击展开）
cURL
curl -X POST "https://ksicdata.com/api/addKeywordTask" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"keyword": "ssd",
"region": "us",
"zipCode": "10001"
}
]'响应示例
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}采集数据示例 （点击展开）
JSON
{
"keyword": "ssd",
"page": 1,
"pageSize": 16,
"total": 35114,
"date": 1788933441091,
"data": [
{ "asin": "B09TVXVMVL", "type": 3 },
{ "asin": "B0BHJJ9Y77", "bought": "6K+", "type": 4 },
{ "asin": "B08HN37XC1", "bought": "7K+", "type": 5 },
{ "asin": "B0874XN4D8", "bought": "3K+", "type": 6 }
],
"spProduct": [
{ "asin": "B09TVXVMVL", "info": { "widgetName": "sp_atf", "adId": "301470447530102", "adIndex": "0" } }
],
"sbInfo": [
{ "asins": ["B0CM8W1S8K", "B0CM63ZP2Y"], "info": [{ "adId": "301302846015102", "title": "fanxiang" }] }
],
"sbvProduct": [
{ "adId": "301199430453502", "asins": ["B0DX2G349M", "B0DX2DPJZ5"], "widgetType": "video-product-collection" }
],
"relatedSearches": ["ssd 2tb", "pc case", "ram", "ssd m.2"],
"brands": ["Samsung", "Sandisk", "Kingston", "Crucial"],
"sellers": [{ "id": "ATVPDKIKX0DER", "name": "Amazon.com" }]
}返回字段
完整字段说明（含截图）见 API 参考附录中的关键词采集字段说明，共 15 个字段。
查看完整字段说明（含截图）所有接口均以 https://ksicdata.com/api 为前缀，POST 提交 JSON 数组，通过 ks-token 认证；单次最多 2000 条。
常见问题
每个关键词采集几页？
采集搜索结果前 3 页。
关键词长度有限制吗？
关键词长度需小于 200，超出会返回 10003 错误。
为什么 SP 广告数量每次不同？
搜索页广告展示受账号环境、邮编与时间影响，采集到的 SP 广告数量因人而异。
哪些站点不支持关键词任务？
南非站点（za）目前不支持关键词采集任务，提交会返回 10005 站点不支持。
