addKeywordTask:关键词搜索数据接口

提交关键词,采集搜索结果页数据(默认前 3 页,可用 page 参数最多扩到 20 页),返回每个 ASIN 的展示顺序与位置类型(SP 广告 / Amazon’s Choice / Best Seller / 自然位)。

POST https://openapi.ksicdata.com/api/addKeywordTask

请求参数

参数类型必填说明
keywordstring是搜索关键词,例如 ssd,长度需小于 200
pageinteger否最大采集页数,取值 1~20,不传则默认 3 页
regionstring是站点代码,例如 us,取值见支持站点
zipCodestring是收货邮编,必填,用于模拟本地配送地址

请求示例

JSON
[
  {
    "keyword": "ssd",
    "page": 10,
    "region": "us",
    "zipCode": "10001"
  }
]
curl 示例 (点击展开)
cURL
curl -X POST "https://openapi.ksicdata.com/api/addKeywordTask" \
  -H "Content-Type: application/json" \
  -H "ks-token: YOUR_TOKEN" \
  -d '[
    {
      "keyword": "ssd",
      "page": 10,
      "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://openapi.ksicdata.com/api 为前缀,POST 提交 JSON 数组,通过 ks-token 认证;单次最多 2000 条。

常见问题

每个关键词能采集几页?

默认采集搜索结果前 3 页;传 page 参数可指定采集页数,最大 20 页,不传则按 3 页处理。

page 参数怎么用?

page 为 Integer,表示最大采集页数,取值 1~20。例如 page=10 表示采集该关键词搜索结果的前 10 页,数据按页返回。

关键词长度有限制吗?

关键词长度需小于 200,超出会返回 10003 错误。

为什么 SP 广告数量每次不同?

搜索页广告展示受账号环境、邮编与时间影响,采集到的 SP 广告数量因人而异。

哪些站点不支持关键词任务?

南非站点(za)目前不支持关键词采集任务,提交会返回 10005 站点不支持。

准备好获取您的 Amazon 数据了吗?

扫码添加客服,获取专属报价和免费数据样本。

WeChat customer service QR code

微信扫码添加客服

获取专属报价和技术咨询

或发送邮件至
deepsleep@kszcdata.cn