接口地址 认证方式 ASIN 任务 关键词任务 BSR 榜单任务 类目前400任务 卖家店铺任务 卖家ASIN任务 错误码 支持站点 可用邮编 ASIN字段 关键词字段 BSR字段 类目字段 卖家字段 卖家ASIN
API Documentation

API 文档

通过以下接口，您可以提交 ASIN、关键词、BSR 榜单、类目前 400、卖家店铺等 Amazon 数据采集任务。 任务提交成功后，系统将异步采集数据，并按约定的交付方式提供。数据字段说明见下方附录章节。

https://ksicdata.com/api POST · JSON 批量上限 2000 条/次 支持 23 个站点
各接口独立文档： addAsinTask addKeywordTask addBsr100Task addCategory400Task addSellerTask addSellerAsinTask

接口地址

所有接口均以 https://ksicdata.com/api 为前缀，完整地址为基础地址 + 接口名，例如：

Text 
https://ksicdata.com/api/addAsinTask
https://ksicdata.com/api/addKeywordTask
https://ksicdata.com/api/addBsr100Task
https://ksicdata.com/api/addCategory400Task
https://ksicdata.com/api/addSellerTask
https://ksicdata.com/api/addSellerAsinTask
  • 请求方式：POST；请求头需携带 Content-Type: application/json。
  • 请求体：JSON 数组，支持批量提交任务，单次请求最多 2000 条，超出将返回 10002 错误。
  • 响应格式：统一为 JSON，结构见「通用返回」。

认证方式

所有接口都需要身份认证，请在请求头或 Cookie 中携带平台分配的 token：

HTTP 
# 方式一：请求头
ks-token: YOUR_TOKEN

# 方式二：Cookie
ks-token=YOUR_TOKEN

用户身份由服务端根据 ks-token 自动解析，请求体中无需传入 userId 参数。

提示：token 由平台在开通 API 权限时分配，尚未开通？扫码联系客服获取 ks-token 与专属报价。 token 缺失、无效或已过期时，接口返回 401（权限不足）。

通用返回

所有接口的响应体结构一致：

字段类型说明
codeinteger状态码，0 表示成功，非 0 表示失败，详见「错误码」
msgstring返回信息
tlong服务器时间戳（毫秒）

成功响应示例

JSON 
{
  "code": 0,
  "msg": "请求成功",
  "t": 1735891200000
}

失败响应示例

JSON 
{
  "code": 10002,
  "msg": "超出批量限制",
  "t": 1735891200000
}

提交 ASIN 采集任务

提交 ASIN 列表，系统将采集对应商品详情页（Listing）数据，包括标题、价格、评分、评论数、BSR 排名、变体、图片等字段。

POST https://ksicdata.com/api/addAsinTask

请求参数

请求体为 JSON 数组，可批量提交，单次最多 2000 条。

参数类型必填说明
asinstring是ASIN 编码，例如 B0CB3TJ46F
regionstring是站点代码，例如 us，取值见「支持站点」
zipCodestring是收货邮编，必填，用于模拟本地配送地址，影响价格与库存的展示，可用邮编见「站点可用邮编」

请求示例

JSON 
[
  {
    "asin": "B0CB3TJ46F",
    "region": "us",
    "zipCode": "10001"
  }
]
curl 示例 （点击展开）
cURL 
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"
    }
  ]'

响应示例

JSON 
{
  "code": 0,
  "msg": "请求成功",
  "t": 1735891200000
}
采集数据示例 （点击展开）

以下为 addAsinTask 采集到的商品详情页数据格式示例：

JSON 
{
    "ac": true,
    "aplus": false,
    "asin": "B0CB3TJ46F",
    "bought": "100+ bought",
    "brandName": "Fitede",
    "bs": false,
    "bundleItems": [
        "B0CQ7WZBJ2",
        "B09M8NTXMG"
    ],
    "buybox": 16.49,
    "climatePledgeFriendly": false,
    "currency": "$",
    "customersAspects": [
        "Functionality",
        "Fit",
        "Value for money"
    ],
    "customersSay": "Customers report that the transmission filter oil pan gasket kit works great. However, the fit and value for money receive mixed feedback - while some say it fits perfectly and offers decent pricing, others mention compatibility issues with specific models like the 2015 Rogue SL and find it overpriced.",
    "date": 1788933552498,
    "description": "Advantage: Tested & Certified to Meet or Exceed OEM Quality Standards. 100% Tested Before Leaving the Factory. Made of High Quality Material. Replace Part Number: 31728-1XF03, 31726-1XF00, 31728-1XF02, 31728-1XF0A, 31728-1XH0A, 31728-1XZ0A, 31728-1XZ0D, 31397-1XF0D, 2824A02, 2824A006, 2824A007, 2705A015, 2920A096, 5191890AA, 92724H, JF011E, RE0F10A, RE0F10B Compatible with Nissan Vehicles: 2007-2013 Altima 2011-2016 Juke 2013-2015 NV200 2008-2016 Rogue 2014-2015 Rogue Select 2009-2012 Sentra Compatible with Mitsubishi Vehicles: 2008-2015 Lancer 2008-2017 Outlander 2011-2017 Outlander Sport Compatible with Other Vehicles: 2007-2012 Dodge Caliber 2007-2017 Jeep Compass/Patriot Includes: 1 x Automatic Transmission Filter 1 x Transmission Oil Cooler Filter 1 x Rubber Pan Gasket Warranty: The Transmission Filter Assembly come with 12 Months Warranty. Hassle-Free Return and Refund Policy. Please Buy it with Your Confidence.",
    "dimensions": "5.71 x 5.12 x 2.24 inches;9.1 ounces",
    "featureNames": [],
    "featureValues": [],
    "firstAvailable": "July 4, 2023",
    "firstDate": 1688400000000,
    "fivePoint": [
        "【Function】The Transmission Filter is Made of High-Quality Materials,Which can Filter the Oil,Remove the Impurities,Keep the Oil Clean,Prevent the Valve Body and Other Parts of the Blockage,Which can Effectively Extend the Service Life of the Gearbox.",
        "【Replaces#】31728-1XF03, 31726-1XF00, 31728-1XF02, 31728-1XF0A, 31728-1XH0A, 31728-1XZ0A, 31728-1XZ0D, 31397-1XF0D, 2824A02, 2824A006, 2824A007, 2705A015, 2920A096, 5191890AA, 92724H, JF011E, RE0F10A, RE0F10B.Please Check the OEM Part Number and Make Sure Your Part Number Matches this Part Number Before Buying!",
        "【Compatible】Fit for JF011E RE0F10A Transmission.Fit for Nissan Vehicles:2007-2013 Altima;2011-2016 Juke;2013-2015 NV200;2008-2016 Rogue;2014-2015 Rogue Select;2009-2012 Sentra.Fit for Mitsubishi Vehicles:2008-2015 Lancer;2008-2017 Outlander;2011-2017 Outlander Sport.Fit for 2007-2012 Dodge Caliber.Fit for 2007-2017 Jeep Compass/Patriot.",
        "【Premium Quality】Tested & Certified to Meet or Exceed OEM Quality Standards.All Products are 100% Tested Before Leaving the Factory.Made of High Quality Material.",
        "【Warranty】The Transmission Filter Assembly come with 12 Month Warranty. Hassle-free Return and Refund Policy. Please Buy it with Your Confidence."
    ],
    "mainImage": "https://m.media-amazon.com/images/I/51puNJL+mFL._AC_SL1500_.jpg",
    "mainRank": {
        "rank": 46987,
        "rankName": "Automotive"
    },
    "newOnAmz": false,
    "newReleases": false,
    "nodeIds": [
        "15684181",
        "15719731",
        "15727061",
        "15727281",
        "15727291"
    ],
    "nodeNames": [
        "Automotive",
        "Replacement Parts",
        "Filters",
        "Transmission Filters & Accessories",
        "Filter & Gasket Kits"
    ],
    "offerDisplays": [
        {
            "name": "Ships from",
            "value": "Amazon"
        },
        {
            "name": "Sold by",
            "value": "FTDFITS"
        },
        {
            "name": "Returns",
            "value": "FREE 30-day refund/replacement"
        },
        {
            "name": "Gift options",
            "value": "Available at checkout Secure transaction"
        }
    ],
    "otherRanks": [
        {
            "nodeId": "15727291",
            "rank": 32,
            "rankName": "Automotive Replacement Transmission Filter & Gasket Kits"
        },
        {
            "nodeId": "15724571",
            "rank": 230,
            "rankName": "Automotive Replacement Transmissions & Parts"
        }
    ],
    "price": 16.49,
    "productDocuments": false,
    "productInformation": [
        {
            "name": "Manufacturer",
            "value": "Fitede"
        },
        {
            "name": "Brand",
            "value": "Fitede"
        },
        {
            "name": "Model",
            "value": "Transmission Filter"
        },
        {
            "name": "Item Weight",
            "value": "9.1 ounces"
        },
        {
            "name": "Package Dimensions",
            "value": "5.71 x 5.12 x 2.24 inches"
        },
        {
            "name": "Item model number",
            "value": "31728-1XF02"
        },
        {
            "name": "Exterior",
            "value": "Machined"
        },
        {
            "name": "Manufacturer Part Number",
            "value": "FT-022-FT"
        },
        {
            "name": "ASIN",
            "value": "B0CB3TJ46F"
        },
        {
            "name": "Customer Reviews",
            "value": "       4.4  4.4 out of 5 stars          (429)         4.4 out of 5 stars"
        },
        {
            "name": "Best Sellers Rank",
            "value": "     #46,987 in Automotive (See Top 100 in Automotive)   #32 in Automotive Replacement Transmission Filter & Gasket Kits   #230 in Automotive Replacement Transmissions & Parts   "
        },
        {
            "name": "Date First Available",
            "value": "July 4, 2023"
        }
    ],
    "ratings": 4.4,
    "relateMap": {
        "Similar items that may deliver to you quickly": [
            "B0D7MGY9RF",
            "B0F5P38LFN",
            "B0FJ8R4C6Q",
            "B0D8ZDWWH1",
            "B0GDCN9RKF",
            "B0BJTVNDBD",
            "B0FSJJKVYD",
            "B0BHWN6CY1",
            "B0DPZ1SCJN",
            "B0GDCSXP8J",
            "B0D4PZZM21",
            "B0G1RM7DJN",
            "B0D4Y3N9KZ",
            "B0DMZPF6WS",
            "B0GSFNJVYG",
            "B0D7MMN348",
            "B0GSFXLKHW",
            "B0FXTQ9BF7",
            "B0B31KG685",
            "B0D7MM9NQM",
            "B0D7MJ3862",
            "B0CTMFDSH3",
            "B0BDVHY45M",
            "B0D49D3BC3",
            "B09NKJ497F",
            "B0FHZRQFQW",
            "B0H7R8KRX4",
            "B0CM5LR54X",
            "B0FCXR8SMD"
        ],
        "Frequently bought together": [
            "B093R9YZ75",
            "B0CQJWX183"
        ]
    },
    "reviews": 429,
    "secondaryImage": [
        "https://m.media-amazon.com/images/I/51puNJL+mFL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71SSt7gjQRL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71Xpl2ZtisL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71dyq7-erTL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61oJ9W92AIL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/616eqgFk9JL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61QKHhxdcnL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/51N7tlDow1L._AC_SL1500_.jpg"
    ],
    "sellerFollow": 0,
    "sellerId": "A32T2X8A81QU4X",
    "sellerName": "FTDFITS",
    "sellerType": "FBA",
    "shipPrice": "FREE",
    "stockState": 1,
    "stockStr": "In Stock",
    "subTitle": "Stainless Steel Wire Skimmer Spoon with Long Handle Asian Work Strainer Ladle for Kitchen Cooking and Frying",
    "taskAsin": "B0CB3TJ46F",
    "title": "RE0F10A RE0F10B JF011E Transmission Filter Oil Pan Gasket Kit 31728-1XF02"
}

提交关键词采集任务

提交搜索关键词，系统将采集对应关键词搜索结果 前 3 页 的数据，包括搜索结果 ASIN 排名、广告位分布、自然排名等核心数据。注：受账号环境等因素影响，采集到的 SP 广告数量因人而异。

POST https://ksicdata.com/api/addKeywordTask

请求参数

请求体为 JSON 数组，可批量提交，单次最多 2000 条。

参数类型必填说明
keywordstring是搜索关键词，例如 ssd，长度需小于 200
regionstring是站点代码，例如 us（南非 za 不支持关键词任务）
zipCodestring是收货邮编，必填，用于模拟本地配送地址，可用邮编见「站点可用邮编」

请求示例

JSON 
[
  {
    "keyword": "ssd",
    "region": "us",
    "zipCode": "10001"
  }
]
curl 示例 （点击展开）
cURL 
curl -X POST "https://ksicdata.com/api/addKeywordTask" \
  -H "Content-Type: application/json" \
  -H "ks-token: YOUR_TOKEN" \
  -d '[
    {
      "keyword": "ssd",
      "region": "us",
      "zipCode": "10001"
    }
  ]'

响应示例

JSON 
{
  "code": 0,
  "msg": "请求成功",
  "t": 1735891200000
}
采集数据示例 （点击展开）

以下为 addKeywordTask 采集到的搜索结果页数据格式示例：

JSON 
{
    "brands": [
        "Samsung",
        "Sandisk",
        "Kingston",
        "PNY",
        "Lexar",
        "Crucial",
        "Seagate",
        "Patriot Memory",
        "TEAMGROUP",
        "Acer",
        "Western Digital",
        "fanxiang",
        "Gigastone",
        "KingSpec",
        "OWC",
        "Verbatim",
        "Dell",
        "SP Silicon Power",
        "SSK",
        "WD_BLACK",
        "LaCie",
        "Fikwot",
        "ADATA",
        "Intel",
        "Corsair",
        "ORICO",
        "Transcend",
        "ASUS",
        "INLAND",
        "Bestoss",
        "Yottamaster",
        "BIWIN",
        "UGREEN",
        "KEXIN",
        "iDiskk",
        "Oemgenuine",
        "Water Panther",
        "SUNEAST",
        "MECCANIXITY",
        "THREE COLOUR DOGFISH"
    ],
    "data": [
        {
            "asin": "B09TVXVMVL",
            "type": 3
        },
        {
            "asin": "B0FFSWLYN6",
            "type": 3
        },
        {
            "asin": "B0BHJJ9Y77",
            "bought": "6K+",
            "type": 4
        },
        {
            "asin": "B08HN37XC1",
            "bought": "7K+",
            "type": 5
        },
        {
            "asin": "B0H6X892M7",
            "bought": "",
            "type": 6
        },
        {
            "asin": "B0BHJF2VRN",
            "bought": "4K+",
            "type": 5
        },
        {
            "asin": "B0B1H6NHWM",
            "type": 3
        },
        {
            "asin": "B0DX2DPJZ5",
            "bought": "3K+",
            "type": 6
        },
        {
            "asin": "B08QB93S6R",
            "bought": "1K+",
            "type": 6
        },
        {
            "asin": "B0H1NH99GX",
            "bought": "1K+",
            "type": 6
        },
        {
            "asin": "B0DBR3DZWG",
            "bought": "4K+",
            "type": 6
        },
        {
            "asin": "B0CX94D2YC",
            "bought": "400+",
            "type": 3
        },
        {
            "asin": "B0DN7CYYSD",
            "bought": "2K+",
            "type": 6
        },
        {
            "asin": "B0GMWYYRQL",
            "bought": "3K+",
            "type": 5
        },
        {
            "asin": "B0CHFSWM2P",
            "bought": "3K+",
            "type": 6
        },
        {
            "asin": "B07XZLN9KM",
            "bought": "1K+",
            "type": 6
        },
        {
            "asin": "B0DL2ZW5Q5",
            "type": 3
        },
        {
            "asin": "B087K9L3R5",
            "bought": "1K+",
            "type": 6
        },
        {
            "asin": "B0DX2G349M",
            "bought": "1K+",
            "type": 6
        },
        {
            "asin": "B0874XWW23",
            "bought": "1K+",
            "type": 6
        },
        {
            "asin": "B0874XN4D8",
            "bought": "3K+",
            "type": 6
        },
        {
            "asin": "B0HCY57C89",
            "bought": "100+",
            "type": 3
        }
    ],
    "date": 1788933441091,
    "keyword": "ssd",
    "multiAdFeedback": [],
    "otherSbInfo": [
        {
            "adId": "301302846015102",
            "campaignId": "200082725590771",
            "title": "fanxiang"
        },
        {
            "adCreativeId": "0",
            "adId": "301333305963202",
            "advertiserIdNS": "axiom.ATVPDKIKX0DER.A2BOK2Y6E6BOLM",
            "campaignId": "300046127002206",
            "title": "Sandisk"
        },
        {
            "adCreativeId": "0",
            "adId": "301193262196402",
            "advertiserIdNS": "axiom.ATVPDKIKX0DER.A34PF29WPO2NUY",
            "campaignId": "200065924605171",
            "title": "ORICO"
        },
        {
            "adCreativeId": "0",
            "adId": "300841565001702",
            "advertiserIdNS": "axiom.ATVPDKIKX0DER.A307CH216CTGMP",
            "campaignId": "300067183000406",
            "title": "TerraMaster"
        }
    ],
    "page": 1,
    "pageSize": 16,
    "relatedSearches": [
        "ssd 2tb",
        "pc case",
        "ram",
        "ssd m.2",
        "eptwfu01",
        "w10295370a water filter"
    ],
    "sbInfo": [
        {
            "asins": [
                "B0CM8W1S8K",
                "B0CM63ZP2Y",
                "B0CM8M8293",
                "B0CM8QWND1",
                "B0CM396BR5"
            ],
            "info": [
                {
                    "adId": "301302846015102",
                    "campaignId": "200082725590771",
                    "title": "fanxiang"
                }
            ]
        }
    ],
    "sbvProduct": [
        {
            "adId": "301199430453502",
            "advertiserId": "1180265711302",
            "asins": [
                "B0DX2G349M",
                "B0DX2DPJZ5",
                "B0DX2GJ1YR",
                "B0DX2G349M",
                "B0DX2DPJZ5",
                "B0DX2GJ1YR"
            ],
            "campaignId": "200066018753971",
            "clientId": "1146297-2425835-3050475",
            "marketplaceId": "ATVPDKIKX0DER",
            "pageNumber": "1",
            "pageType": "Search",
            "searchQuery": "ssd",
            "videoSrc": "https://m.media-amazon.com/images/S/al-na-9d5791cf-3faf/be609b97-5adf-4991-a0b6-e0b24de24674.mp4/productVideoOptimized.mp4",
            "widgetType": "video-product-collection"
        }
    ],
    "sbvSingleProductList": [
        {
            "adId": "301481935525902",
            "advertiserId": "28478593802",
            "asin": "B0BNB5VJYM",
            "campaignId": "200107483698171",
            "deviceOs": "unrecognized",
            "language": "en_US",
            "marketplaceId": "ATVPDKIKX0DER",
            "pageNumber": "1",
            "pageType": "Search",
            "searchQuery": "ssd",
            "videoSrc": "https://m.media-amazon.com/images/S/al-na-9d5791cf-3faf/6a87dee6-ca4e-4321-ade4-11e35c8498aa.mp4/productVideoOptimized.mp4",
            "videoType": "sponsored",
            "widgetIndex": "19",
            "widgetType": "SINGLEPRODUCT"
        },
        {
            "adId": "301328770019902",
            "advertiserId": "459662793602",
            "asin": "B0CX94D2YC",
            "campaignId": "200089582583671",
            "deviceOs": "unrecognized",
            "language": "en_US",
            "marketplaceId": "ATVPDKIKX0DER",
            "pageNumber": "1",
            "pageType": "Search",
            "searchQuery": "ssd",
            "videoSrc": "https://m.media-amazon.com/images/S/al-na-9d5791cf-3faf/feed6299-8874-45c6-b635-148adfd41fb7.mp4/productVideoOptimized.mp4",
            "videoType": "sponsored",
            "widgetIndex": "31",
            "widgetType": "SINGLEPRODUCT"
        }
    ],
    "sellers": [
        {
            "id": "AZFWA4N8RPTV7",
            "name": "ZAR Systems Germany"
        },
        {
            "id": "A27S8ZOPVER272",
            "name": "ArchMemory"
        },
        {
            "id": "ATVPDKIKX0DER",
            "name": "Amazon.com"
        },
        {
            "id": "AE3YR9AX5P25J",
            "name": "CorteseInc"
        },
        {
            "id": "A3VDZYEX6FFODH",
            "name": "COMP XP"
        },
        {
            "id": "A73D0XU1SPJHU",
            "name": "Neutron USA"
        },
        {
            "id": "A2DKF1L73WUF4Q",
            "name": "Amazon Germany"
        }
    ],
    "spProduct": [
        {
            "asin": "B09TVXVMVL",
            "info": {
                "widgetName": "sp_atf",
                "adId": "301470447530102",
                "adIndex": "0",
                "qualifier": "1788933443",
                "id": "1494849547532381",
                "eventType": "1"
            }
        },
        {
            "asin": "B0FFSWLYN6",
            "info": {
                "widgetName": "sp_atf",
                "adId": "301126744974302",
                "adIndex": "1",
                "qualifier": "1788933443",
                "id": "1494849547532381",
                "eventType": "1"
            }
        },
        {
            "asin": "B0B1H6NHWM",
            "info": {
                "widgetName": "sp_mtf",
                "adId": "301497767313502",
                "adIndex": "2",
                "qualifier": "1788933443",
                "id": "1494849547532381",
                "eventType": "1"
            }
        },
        {
            "asin": "B0CX94D2YC",
            "info": {
                "widgetName": "sp_mtf",
                "adId": "301276315635102",
                "adIndex": "3",
                "qualifier": "1788933443",
                "id": "1494849547532381",
                "eventType": "1"
            }
        },
        {
            "asin": "B0DL2ZW5Q5",
            "info": {
                "widgetName": "sp_mtf",
                "adId": "300625208096702",
                "adIndex": "4",
                "qualifier": "1788933443",
                "id": "1494849547532381",
                "eventType": "1"
            }
        },
        {
            "asin": "B0HCY57C89",
            "info": {
                "widgetName": "sp_btf",
                "adId": "301437404963002",
                "adIndex": "5",
                "qualifier": "1788933443",
                "id": "1494849547532381",
                "eventType": "1"
            }
        }
    ],
    "total": 35114
}

提交 BSR 榜单采集任务

提交 BSR 榜单链接，系统将采集该榜单前 100 名商品数据。type 字段：1 = BSR 畅销榜（Best Sellers），2 = New Releases 新品榜。

POST https://ksicdata.com/api/addBsr100Task

请求参数

请求体为 JSON 数组，可批量提交，单次最多 2000 条。

参数类型必填说明
suffixUrlstring是榜单页完整 URL（需带域名），URL 中问号 ? 之后的参数会被服务端自动去除，示例见下方说明
typestring是榜单类型：1 = BSR 畅销榜，2 = New Releases 新品榜
regionstring是站点代码，例如 us，取值见「支持站点」
zipCodestring是收货邮编，必填，用于模拟本地配送地址，可用邮编见「站点可用邮编」

suffixUrl 示例

Text 
https://www.amazon.com/Best-Sellers-Baby-Baby-Care-Products/zgbs/baby-products/17720255011/ref=zg_bs_nav_baby-products_1
https://www.amazon.com/gp/new-releases/baby-products/166863011/ref=zg_bsnr_pg_2_baby-products?ie=UTF8&pg=2
注意：suffixUrl 需为带域名的完整 URL；URL 中问号 ? 之后的参数会被服务端自动去除。

请求示例

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 示例 （点击展开）
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"
    }
  ]'

响应示例

JSON 
{
  "code": 0,
  "msg": "请求成功",
  "t": 1735891200000
}
采集数据示例 （点击展开）

以下为 addBsr100Task 采集到的榜单 ASIN 数据格式示例（字段说明见附录「BSR 榜单字段说明」）：

JSON 
{
    "asins": [
        "B0H7J36CWB",
        "B0HGFSZ1NF",
        "B0GQS8C35N",
        "B0HBLYJ8QS",
        "B0H6L2CC95",
        "B0H947W4TN",
        "B0H6SHHJ2K",
        "B0HB3VVH2D",
        "B0H9YN1T4V",
        "B0H6WKFYBL",
        "B0H2YZ9J13",
        "B0H7TP8RZF",
        "B0H5BR6R7Z",
        "B0H1L84XQM",
        "B0H4TC6CMQ",
        "B0GY8H621F",
        "B0HC6KLZ82",
        "B0H8CP1Z8S",
        "B0HBBBQP8F",
        "B0H9R9TKHQ",
        "B0HBBKQLGD",
        "B0HHNH7DYQ",
        "B0GXVLBMSM",
        "B0H7BMS3HJ",
        "B0HB4G8H66",
        "B0HBBV1GZ4",
        "B0H6FSZD6H",
        "B0H58SZNZJ",
        "B0H7JLCVNC",
        "B0H5BVHCTG",
        "B0HG9SF4ZX",
        "B0HDHMQFGZ",
        "B0H2DND3GC",
        "B0H4C4B3R7",
        "B0H32KTRDX",
        "B0H417NZQD",
        "B0H8MYZ4LV",
        "B0H69633K1",
        "B0H1D27V2F",
        "B0HC6J5VSS",
        "B0H7RQG6M9",
        "B0HCBMH9CF",
        "B0H5RGSZSZ",
        "B0H9493P6L",
        "B0HD718DYJ",
        "B0H5W1BR3Z",
        "B0H837ND2M",
        "B0HC6JDYKZ",
        "B0H3F5MTP7",
        "B0GZWLWVXB"
    ],
    "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"
}

提交类目前 400 采集任务

提交类目节点，系统将采集该节点下榜单的任务，抓取每页中的 ASIN。可通过 page 指定抓取页数（最大 400 页，不填默认 400 页）。

POST https://ksicdata.com/api/addCategory400Task

请求参数

请求体为 JSON 数组，可批量提交，单次最多 2000 条。

参数类型必填说明
nodeIdstring是类目节点 ID，例如 17720255011
pageinteger否抓取页数，最大 400，不填默认 400
regionstring是站点代码，例如 us，取值见「支持站点」
zipCodestring是收货邮编，必填，用于模拟本地配送地址，可用邮编见「站点可用邮编」

请求示例

JSON 
[
  {
    "nodeId": "17720255011",
    "page": 400,
    "region": "us",
    "zipCode": "10001"
  }
]
curl 示例 （点击展开）
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"
    }
  ]'

响应示例

JSON 
{
  "code": 0,
  "msg": "请求成功",
  "t": 1735891200000
}
采集数据示例 （点击展开）

以下为 addCategory400Task 采集到的类目榜单 ASIN 数据格式示例（字段说明见附录「类目前 400 字段说明」）：

JSON 
{
  "asins": [
    "B0D14Y57K7",
    "B0DKKVRHK9",
    "B0DPNC61JZ",
    "B0CH1NYCV1",
    "B0DYTZP95B",
    "B0CB5BX8JK",
    "B0CSTFLRK4",
    "B0D2JL223K",
    "B0D2TZYMQG",
    "B0DQKPZ79M",
    "B0DYHGKF9Q",
    "B0F3JC4GWM",
    "B0FP2DDJ2V",
    "B0FBXN44KM",
    "B0CNCVSKWJ",
    "B0GJV2JKN5",
    "B0FHB9B53J",
    "B0CFVF8P2Q",
    "B0CDGW4Y46",
    "B0CLTK8QC1",
    "B0CW2Q38ZD",
    "B0FXGTGQG7",
    "B0CSXWXSR6",
    "B0BRC5GF19"
  ],
  "nodeId": "17720255011",
  "page": 5,
  "region": "us",
  "type": "BSR"
}

提交卖家店铺采集任务

提交卖家 ID，系统将采集该卖家店铺页面的店铺信息，如 Rating 打分情况、店铺地址、店铺介绍、公司名称等。注：部分站点（如加拿大 ca）不显示店铺地址。

POST https://ksicdata.com/api/addSellerTask

请求参数

请求体为 JSON 数组，可批量提交，单次最多 2000 条。

参数类型必填说明
sellerIdstring是卖家 ID，例如 A1738THC4GAJK2
regionstring是站点代码，例如 us，取值见「支持站点」
zipCodestring是收货邮编，必填，用于模拟本地配送地址，可用邮编见「站点可用邮编」

请求示例

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
}
采集数据示例 （点击展开）

以下为 addSellerTask 采集到的店铺信息数据格式示例（字段说明见附录「卖家店铺字段说明」）：

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": [
    "{\"star2Count\":0,\"star5Count\":8,\"ratingCountWithText\":9,\"star4\":0,\"star5\":89,\"star5CountWithText\":8,\"star2\":0,\"star3Count\":0,\"star1Count\":1,\"star3\":0,\"ratingCount\":9,\"star1\":11,\"star4Count\":0,\"star4CountWithText\":0,\"star3CountWithText\":0,\"star1CountWithText\":1,\"star2CountWithText\":0}",
    "{\"star2Count\":0,\"star5Count\":25,\"ratingCountWithText\":28,\"star4\":4,\"star5\":89,\"star5CountWithText\":25,\"star2\":0,\"star3Count\":0,\"star1Count\":2,\"star3\":0,\"ratingCount\":28,\"star1\":7,\"star4Count\":1,\"star4CountWithText\":1,\"star3CountWithText\":0,\"star1CountWithText\":2,\"star2CountWithText\":0}",
    "{\"star2Count\":2,\"star5Count\":124,\"ratingCountWithText\":137,\"star4\":3,\"star5\":91,\"star5CountWithText\":124,\"star2\":1,\"star3Count\":1,\"star1Count\":6,\"star3\":1,\"ratingCount\":137,\"star1\":4,\"star4Count\":4,\"star4CountWithText\":4,\"star3CountWithText\":1,\"star1CountWithText\":6,\"star2CountWithText\":2}",
    "{\"star2Count\":10,\"star5Count\":570,\"ratingCountWithText\":673,\"star4\":6,\"star5\":85,\"star5CountWithText\":569,\"star2\":1,\"star3Count\":16,\"star1Count\":40,\"star3\":2,\"ratingCount\":674,\"star1\":6,\"star4Count\":38,\"star4CountWithText\":38,\"star3CountWithText\":16,\"star1CountWithText\":40,\"star2CountWithText\":10}"
  ],
  "ratingNumber": [
    "4.6",
    "4.7",
    "4.7",
    "4.6"
  ],
  "region": "us",
  "sellerId": "A1738THC4GAJK2",
  "sellerName": "CGR-Leo"
}

提交卖家店铺 ASIN 采集任务

提交卖家 ID，系统将采集该卖家店铺下的商品 ASIN 列表，可用于店铺上新监控。不填 page 时抓取该店铺下的所有 ASIN。

POST https://ksicdata.com/api/addSellerAsinTask

请求参数

请求体为 JSON 数组，可批量提交，单次最多 2000 条。

参数类型必填说明
sellerIdstring是卖家 ID，例如 A2RJLAGU2HCBYM
pageinteger否抓取页数，不填则抓取该店铺下的所有 ASIN，最多 1000 页
regionstring是站点代码，例如 us，取值见「支持站点」
zipCodestring是收货邮编，必填，用于模拟本地配送地址，可用邮编见「站点可用邮编」

请求示例

JSON 
[
  {
    "sellerId": "A2RJLAGU2HCBYM",
    "region": "us",
    "zipCode": "10001"
  }
]
curl 示例 （点击展开）
cURL 
curl -X POST "https://ksicdata.com/api/addSellerAsinTask" \
  -H "Content-Type: application/json" \
  -H "ks-token: YOUR_TOKEN" \
  -d '[
    {
      "sellerId": "A2RJLAGU2HCBYM",
      "region": "us",
      "zipCode": "10001"
    }
  ]'

响应示例

JSON 
{
  "code": 0,
  "msg": "请求成功",
  "t": 1735891200000
}
采集数据示例 （点击展开）

以下为 addSellerAsinTask 采集到的店铺 ASIN 列表数据格式示例（字段说明见附录「卖家店铺 ASIN 字段说明」）：

JSON 
{
  "asins": [
    "B0GHR4CFKQ",
    "B0GGQHMM1K",
    "B0GGQQ5BJQ",
    "B0GFCWM8Q9",
    "B0FZKR62Y4",
    "B0FSJP3H7V",
    "B0FQBNJC51",
    "B0FQBLKYM4",
    "B0FY2T81M6",
    "B0FQBGD4S5",
    "B0FQBH846Q",
    "B0FL6ZXWYC",
    "B0FH6Y2P59",
    "B0FJBQ5ZWS",
    "B0FJD3B7W6",
    "B0DYP5N8VQ"
  ],
  "page": 2,
  "region": "us",
  "sellerId": "A2RJLAGU2HCBYM",
  "userId": "1"
}

错误码

接口通过响应体中的 code 字段返回状态码，非 0 即表示失败：

状态码说明
0请求成功
1请求异常
401权限不足（token 缺失、无效或已过期）
503服务器维护中（维护通常在晚上 11 点后开始，维护时长一般 20 分钟内）
10001参数缺失
10002超出批量限制（单次最多 2000 条）
10003关键词超出长度
10004邮编异常
10005站点不支持

支持站点

region 字段的取值如下，共支持 23 个站点：

站点代码国家/地区域名
us美国amazon.com
de德国amazon.de
ca加拿大amazon.ca
uk英国amazon.co.uk
es西班牙amazon.es
it意大利amazon.it
mx墨西哥amazon.com.mx
in印度amazon.in
fr法国amazon.fr
jp日本amazon.co.jp
br巴西amazon.com.br
ae阿联酋amazon.ae
au澳大利亚amazon.com.au
eg埃及amazon.eg
sa沙特阿拉伯amazon.sa
nl荷兰amazon.nl
se瑞典amazon.se
pl波兰amazon.pl
be比利时amazon.com.be
ie爱尔兰amazon.ie
sg新加坡amazon.sg
tr土耳其amazon.com.tr
za南非amazon.co.za
注意：南非站点（za）不支持关键词采集任务。

站点可用邮编

以下为各站点支持的收货邮编，zipCode 字段请从下表取值：

站点代码邮编城市
us90001洛杉矶
us10001纽约
us60601芝加哥
us84104盐湖城
de10115柏林
de20095汉堡
de80331慕尼黑
jp162-0802东京 新宿区
jp060-0807北海道 札幌市
jp604-8153京都市中京区
jp541-0056大阪市中央区
ukW1S 3PR伦敦
ukB2 4QA伯明翰
ukM1 2AR曼彻斯特
es28001马德里
es08001巴塞罗那
es46001瓦伦西亚
es41001塞维利亚
it00118罗马
it20121米兰
it80100那不勒斯
caM5S 1A1多伦多
caK1A 7P8渥太华
caH2T 2A4蒙特利尔
caV5Z 3N5温哥华
fr75001巴黎
fr13001马赛
fr69001里昂
mx11000墨西哥城
mx44100瓜达拉哈拉
in400001孟买
in110001新德里
br01319-010圣保罗
br20010-000里约热内卢
au2000悉尼
aeDubai迪拜
egالقاهرة开罗
saالرياض利雅得
nl1079阿姆斯特丹
se111 64斯德哥尔摩
pl00-277华沙
be1050布鲁塞尔
ieD04 K6F2都柏林
sg048616莱佛士
tr34912伊斯坦布尔省
za2196约翰内斯堡

ASIN 采集字段说明（addAsinTask）

以下为 addAsinTask 接口采集数据的字段说明（对应原产品文档）。点击表格中的截图可放大查看。

字段名称类型示例截图备注
asinasinStringB0BZZDPPRXasin字段默认就是客户的任务asin，如果页面有currentAsin就拿currentAsin来覆盖asin字段
url访问的的是B0G92ZGB47 ，页面跳转后链接asin变成了 B0G93BYSLX
parentAsin父asinStringB0CJDQJCJV不一定有
brandName品牌名称String
brandId品牌idStringF3FCA711-BFF5-47D1-AF38-D1BE5481408E
ratings评分Double4.3
reviews评论数Integer
title标题String
mainImage主图String
secondaryImage副图List<String>
video视频地址String
price价格Double
buybox购物车价格Double
sellerName卖家名称String
sellerId卖家idStringA2OH0FV1GVQLHQ
sellerFollow跟卖数量Integer
fivePoint五点List<String>
firstAvailable上架日期String
firstDate上架日期 时间戳格式Date1586880000000
mainRank大类信息Object{ "rank": 62, "rankName": "Tools & Home Improvement" }大类与左上角类目不一定一致，所以不返回nodeId,需要自行维护大类的名称对应的id
nodeNames分类目录List<String>
nodeIds分类目录idList<String>
variantAsin变体asinList<Object>[ { "asin": "B07GBNDTQB", "style": [ "7.5", "Dar…
bs是否为bestsellersBoolean
ac是否为Amazon's ChoiceBoolean
newReleases是否为new ReleasesBoolean
climatePledgeFriendly是否为气候友好Boolean
productDocuments是否有产品文档Boolean
description描述String产品文字描述，如果有A+，那就可能没描述
aplus是否有A+Boolean一堆图文介绍产品，一般都有
date数据采集日期Date采集时的时间戳
dimensions尺寸dimensions
listPrice划线价Double
relateMap有关联的asinObject{ "Products related to this item": [ "B07TRT7NR6", "B0BGL1F88Y",…Frequently bought together，Customers also bought，Compare with similar items 等相关的asin
otherRanks小类排名List<Object>[ { "nodeId": "360472031", "rank": 1518, …
bought月销量String
deal折扣Double
coupon优惠券String
primePriceprime价格Double
featureNames产品信息名称List<String>
featureValues产品信息值List<String>
variationsNames变体名称List<String>[ "Size", "Color" ]对应variantAsin字段里的style信息
productInformation产品信息List<Object>[ { "name": "Brand", "value": "Hefty" }, { "name":…asin:B097F7XJM1,productInformation和productDetails一般只存在一个
productDetails产品信息List<Object>asin:B0B3HLLC4L,productInformation和productDetails一般只存在一个
offerDisplays发货信息List<Object>
topBrand大品牌标志String
stockState库存情况Integer-1:未知 1：In Stock 2：Only 5 left in stock - order soon. 3：Currently unavailable. 4: asin已下架，404
stockStr库存情况描述StringIn Stock或者Only 5 left in stock - order soon.之类
customersAspects评论标签List<String>
customersSay评论概述String
newerModelnewerModel asinString位于主图下方
similarItemnewerModel asinString位于五点 下方
sellerType卖家类型StringFBA： “Ships from 是亚马逊 ，sold by 不是亚马逊” FBM： “Ships from 和 sold by 都不是亚马逊” …
shipPrice运费String$8.98 或者 FREE或者空字符
taskAsin任务asinStringB0G92ZGB47客户发过来要采集的asin
currency货币String
newOnAmz是否最近一个月上架Booleanfalse
bundleItems一起售卖List<String>["B0CQ7WZBJ2","B09M8NTXMG"]
subTitle子标题StringStainless Steel Wire Skimmer Spoon with Long Handle…

关键词采集字段说明（addKeywordTask）

以下为 addKeywordTask 接口采集数据的字段说明（对应原产品文档）。点击表格中的截图可放大查看。

字段名称类型示例截图备注
keyword关键词Stringssd
page第几页Integer1
total商品总数Integer
pageSize一页有多少个自然asinInteger
date数据采集日期Date时间戳
sbInfosb广告信息List<Object>{ "asins": [ "B0DHLCRF91", "B08QBL36…
otherSbInfo搜索页底部品牌广告List<Object>[ { "adId": "300458182627102", "adCr…
dataasin数据List<Object>[{ "bought": "100+ bought in past month", "asin": "B089C3TZL9", …type类型， 3:SP,4:AC,5:BS,6:NATURE
multiAdFeedback搜索页中部横幅广告数据List<Object>[ { "adId": "A03719253UPU4SBHUAW8M", …还有Customers frequently viewed ，4 stars and above，Picks from Amazon Influencers等
sbvSingleProductList视频广告的asin信息List<Object>[ { "pageNumber": "1", "campaignId":…单asin的，通常位于底部
sbvProduct视频广告的asin信息List<Object>{ "asins": [ "B0CYR5L92K", "B0DKG8G5J3" ], "ma…多asin的
spProductsp广告的asin信息List<Object>[ { "asin": "B0CXPVGHQH", "info": { …
relatedSearches相关搜索List<String>[ "ssd 2tb", "pc case", "ram", "…
brands左侧品牌List<String> [ "Samsung", "Crucial", "WD_BLACK", …
sellers左侧卖家List<Object> [ { "name": "USA BUY", "id": "AQE66…

BSR 榜单字段说明（addBsr100Task）

addBsr100Task 接口采集数据的返回字段：

字段名称类型说明
asinsASIN 列表List<String>页面采集到的 asin，顺序即排名顺序；第二页则从第 51 名开始
page页码Integer1 或 2
region国家String站点代码，如 us
type榜单类型StringNEW_RELEASE_TOP100 或 BSR_TOP100
url榜单链接String返回用户传入的 url（问号 ? 之后的参数已去除），方便判断任务来源

类目前 400 字段说明（addCategory400Task）

addCategory400Task 接口采集数据的返回字段：

字段名称类型说明
asinsASIN 列表List<String>页面采集到的 asin，顺序为页面 asin 展示的顺序
page页码Integer1 ~ 400
nodeId类目节点 IDString传入的 nodeId
region国家String站点代码，如 us
type榜单类型String固定为 BSR

卖家店铺字段说明（addSellerTask）

addSellerTask 接口采集数据的返回字段：

字段名称类型说明
address地址List<String>店铺地址（部分站点如加拿大不返回）
businessName名称String公司名称
ratingCount各个评分数量List<String>各个评分的数量（JSON 字符串）
ratingNumber打分情况List<String>1 月内、3 月内、12 月内、开店以来的打分情况
region国家String站点代码，如 us
sellerId卖家 IDString卖家 id
sellerName卖家名称String卖家名称

卖家店铺 ASIN 字段说明（addSellerAsinTask）

addSellerAsinTask 接口采集数据的返回字段：

字段名称类型说明
asinsASIN 列表List<String>页面采集到的 asin，顺序为页面展示顺序，越靠前上架日期越新
page页码Integer页码
region国家String站点代码，如 us
sellerId卖家 IDString卖家 id
微信客服二维码

微信扫码添加客服

获取专属报价和技术咨询

或发送邮件至
deepsleep@kszcdata.cn

字段截图