addBsr100Task: BSR List Collection API
Submit a full Best Sellers or New Releases list URL to collect the top 100 product ASINs from that list.
POST
https://ksicdata.com/api/addBsr100Task
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
suffixUrl | string | Yes | Full list page URL (domain included); parameters after ? are stripped |
type | string | Yes | List type: 1 = Best Sellers (BSR), 2 = New Releases |
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
[
{
"suffixUrl": "https://www.amazon.com/gp/new-releases/baby-products/166863011/ref=zg_bsnr_pg_2_baby-products?ie=UTF8&pg=2",
"region": "us",
"zipCode": "10001",
"type": "2"
}
]cURL example (click to expand)
cURL
curl -X POST "https://ksicdata.com/api/addBsr100Task" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"suffixUrl": "https://www.amazon.com/gp/new-releases/baby-products/166863011/ref=zg_bsnr_pg_2_baby-products?ie=UTF8&pg=2",
"region": "us",
"zipCode": "10001",
"type": "2"
}
]'Response example
JSON
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}Collected data sample (click to expand)
JSON
{
"asins": [
"B0H7J36CWB", "B0HGFSZ1NF", "B0GQS8C35N", "B0HBLYJ8QS", "B0H6L2CC95",
"B0H947W4TN", "B0H6SHHJ2K", "B0HB3VVH2D", "B0H9YN1T4V", "B0H6WKFYBL"
],
"page": 2,
"region": "us",
"type": "NEW_RELEASE_TOP100",
"url": "https://www.amazon.com/gp/new-releases/baby-products/166863011/ref=zg_bsnr_pg_2_baby-products"
}Returned fields
| Field | Name | Type | Description |
|---|---|---|---|
asins | ASIN 列表 | List<String> | ASINs in ranking order; page 2 starts at rank 51 |
page | 页码 | Integer | 1 or 2 |
region | 国家 | String | Marketplace code, e.g. us |
type | 榜单类型 | String | NEW_RELEASE_TOP100 or BSR_TOP100 |
url | 榜单链接 | String | The submitted url (query string removed) for task traceability |
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
Does suffixUrl need the full URL?
Yes — include the domain. Any parameters after the ? are stripped automatically by the server.
What should type be?
Use 1 for the Best Sellers list and 2 for New Releases.
How do I collect page 2?
Use the second-page URL (containing pg=2) as suffixUrl; asins then cover ranks 51-100 and page is 2.
Example list URL?
For example https://www.amazon.com/Best-Sellers-Baby-Baby-Care-Products/zgbs/baby-products/17720255011/ref=zg_bs_nav_baby-products_1 .
Related pages
Ready to get your Amazon data?
Scan the QR code for a custom quote and a free data sample.
