addCategory400Task: Category Top 400 API
Submit a category node ID to collect the ASINs listed across that category’s ranking pages — up to 400 pages — for bulk product discovery.
POST
https://ksicdata.com/api/addCategory400Task
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
nodeId | string | Yes | Category node ID, e.g. 17720255011 |
page | integer | No | Number of pages to collect, max 400; defaults to 400 |
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
[
{
"nodeId": "17720255011",
"page": 400,
"region": "us",
"zipCode": "10001"
}
]cURL example (click to expand)
cURL
curl -X POST "https://ksicdata.com/api/addCategory400Task" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"nodeId": "17720255011",
"page": 400,
"region": "us",
"zipCode": "10001"
}
]'Response example
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}Collected data sample (click to expand)
JSON
{
"asins": [
"B0D14Y57K7", "B0DKKVRHK9", "B0DPNC61JZ", "B0CH1NYCV1",
"B0DYTZP95B", "B0CB5BX8JK", "B0CSTFLRK4", "B0D2JL223K"
],
"nodeId": "17720255011",
"page": 5,
"region": "us",
"type": "BSR"
}Returned fields
| Field | Name | Type | Description |
|---|---|---|---|
asins | ASIN 列表 | List<String> | ASINs in page display order |
page | 页码 | Integer | 1 - 400 |
nodeId | 类目节点 ID | String | Echoed nodeId |
region | 国家 | String | Marketplace code, e.g. us |
type | 榜单类型 | String | Always BSR |
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
What happens if page is omitted?
page is optional; when omitted the task collects 400 pages by default (maximum 400).
Where do I find nodeId?
It is the Amazon category node ID from the category URL, e.g. 17720255011 in /zgbs/baby-products/17720255011/.
Does this return product details?
No — it returns the ASIN list for the category lists. Use addAsinTask afterwards for detail data.
What is the type field?
It is always BSR, indicating the data came from a category ranking list.
Related pages
Ready to get your Amazon data?
Scan the QR code for a custom quote and a free data sample.
