addSellerTask: Seller Store Information API
Submit a seller ID to collect store page information: ratings, store address, business name and the breakdown of star ratings.
POST
https://ksicdata.com/api/addSellerTask
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
sellerId | string | Yes | Seller ID, e.g. A1738THC4GAJK2 |
region | string | Yes | Marketplace code, e.g. us — see supported marketplaces |
zipCode | string | Yes | Delivery postal code (required) — simulates a local delivery address |
Request example
JSON
[
{
"sellerId": "A1738THC4GAJK2",
"region": "us",
"zipCode": "10001"
}
]cURL example (click to expand)
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"
}
]'Response example
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}Collected data sample (click to expand)
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"
}Returned fields
| Field | Name | Type | Description |
|---|---|---|---|
address | 地址 | List<String> | Store address (not returned for some marketplaces, e.g. Canada) |
businessName | 名称 | String | Business name |
ratingCount | 各个评分数量 | List<String> | Per-star rating counts (JSON string) |
ratingNumber | 打分情况 | List<String> | Ratings for 1 / 3 / 12 months and lifetime |
region | 国家 | String | Marketplace code, e.g. us |
sellerId | 卖家 ID | String | Seller ID |
sellerName | 卖家名称 | String | Seller display name |
Every endpoint uses the https://ksicdata.com/api prefix, accepts a JSON array over POST, authenticates with ks-token and allows up to 2000 items per request.
FAQ
Why is the address empty?
Some marketplaces such as Canada (ca) do not publish a store address, so the address field is empty.
What is inside ratingCount?
Each element is a JSON string with per-star counts and the number of ratings that include review text.
Does ratingNumber have four values?
Yes — ratings for the last 1 month, 3 months, 12 months and since the store opened.
Can I collect the store’s products?
Use addSellerAsinTask to collect the ASIN list of a seller store.
Related pages
Ready to get your Amazon data?
Scan the QR code for a custom quote and a free data sample.
