addSellerTask：卖家店铺信息采集接口
提交卖家 ID，采集该卖家店铺页面的店铺信息：评分、店铺地址、公司名称与各星级评价分布。
POST
https://ksicdata.com/api/addSellerTask
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sellerId | string | 是 | 卖家 ID，例如 A1738THC4GAJK2 |
region | string | 是 | 站点代码，例如 us，取值见支持站点 |
zipCode | string | 是 | 收货邮编，必填，用于模拟本地配送地址 |
请求示例
JSON
[
{
"sellerId": "A1738THC4GAJK2",
"region": "us",
"zipCode": "10001"
}
]curl 示例 （点击展开）
cURL
curl -X POST "https://ksicdata.com/api/addSellerTask" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"sellerId": "A1738THC4GAJK2",
"region": "us",
"zipCode": "10001"
}
]'响应示例
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}采集数据示例 （点击展开）
JSON
{
"address": [
"FLAT C 9/F WINNING HOUSE",
"72-74 WING LOK ST",
"SHEUNG WAN HK",
"HK",
"999077",
"HK"
],
"businessName": "CGR TRADING COMPANY LIMITED",
"ratingCount": [
"{\"star5Count\":570,\"star4Count\":38,\"star3Count\":16,\"star2Count\":10,\"star1Count\":40,\"ratingCount\":674}"
],
"ratingNumber": ["4.6", "4.7", "4.7", "4.6"],
"region": "us",
"sellerId": "A1738THC4GAJK2",
"sellerName": "CGR-Leo"
}返回字段
| 字段 | 名称 | 类型 | 说明 |
|---|---|---|---|
address | 地址 | List<String> | 店铺地址（部分站点如加拿大不返回） |
businessName | 名称 | String | 公司名称 |
ratingCount | 各个评分数量 | List<String> | 各星级评分数量（JSON 字符串） |
ratingNumber | 打分情况 | List<String> | 1 月内、3 月内、12 月内、开店以来的打分情况 |
region | 国家 | String | 站点代码，如 us |
sellerId | 卖家 ID | String | 卖家 id |
sellerName | 卖家名称 | String | 卖家名称 |
所有接口均以 https://ksicdata.com/api 为前缀，POST 提交 JSON 数组，通过 ks-token 认证；单次最多 2000 条。
常见问题
为什么没有地址？
部分站点（如加拿大 ca）不显示店铺地址，此时 address 字段为空。
ratingCount 是什么结构？
每个元素是一段 JSON 字符串，包含各星级数量与带文字评价数量等统计。
ratingNumber 有 4 个值？
依次对应 1 月内、3 月内、12 月内和开店以来的店铺打分。
可以采集店铺商品吗？
采集店铺商品 ASIN 请使用 addSellerAsinTask 接口。
