addAsinTask: ASIN Product Detail API
Submit a list of ASINs to collect the corresponding product detail pages, returning title, price, ratings, review counts, BSR ranks, variations and rich content.
https://ksicdata.com/api/addAsinTask
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
asin | string | Yes | ASIN code, e.g. B0CB3TJ46F |
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
[
{
"asin": "B0CB3TJ46F",
"region": "us",
"zipCode": "10001"
}
]cURL example (click to expand)
curl -X POST "https://ksicdata.com/api/addAsinTask" \
-H "Content-Type: application/json" \
-H "ks-token: YOUR_TOKEN" \
-d '[
{
"asin": "B0CB3TJ46F",
"region": "us",
"zipCode": "10001"
}
]'Response example
{
"code": 0,
"msg": "请求成功",
"t": 1735891200000
}Collected data sample (click to expand)
{
"asin": "B0CB3TJ46F",
"parentAsin": "B0CJDQJCJV",
"brandName": "Fitede",
"ratings": 4.4,
"reviews": 429,
"title": "RE0F10A RE0F10B JF011E Transmission Filter Oil Pan Gasket Kit 31728-1XF02",
"subTitle": "Stainless Steel Wire Skimmer Spoon with Long Handle Asian Work Strainer Ladle for Kitchen Cooking and Frying",
"bundleItems": ["B0CQ7WZBJ2", "B09M8NTXMG"],
"price": 16.49,
"buybox": 16.49,
"currency": "$",
"bs": false,
"ac": true,
"newReleases": false,
"newOnAmz": false,
"mainRank": { "rank": 46987, "rankName": "Automotive" },
"nodeNames": ["Automotive", "Replacement Parts", "Filters"],
"sellerId": "A32T2X8A81QU4X",
"sellerName": "FTDFITS",
"sellerType": "FBA",
"stockState": 1,
"stockStr": "In Stock",
"bought": "100+ bought",
"date": 1788933552498,
"taskAsin": "B0CB3TJ46F"
}Returned fields
The complete field reference (with screenshots) lives in the API reference appendix — 58 ASIN fields.
View the full field reference (with screenshots)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
How many ASINs can I submit at once?
The body is a JSON array with a limit of 2000 items per request; exceeding it returns error 10002.
Is zipCode required?
Yes. It simulates a local delivery address so prices, shipping and stock match what shoppers see at that location.
Why can the returned asin differ from the submitted one?
If the page redirects, asin reflects the ASIN actually shown (currentAsin), while taskAsin keeps the ASIN you submitted for reconciliation.
Do I need to send userId?
No. The server resolves the user from the ks-token, so userId is not required in the body.
Related pages
Ready to get your Amazon data?
Scan the QR code for a custom quote and a free data sample.
