简体中文

English

简体中文

English

Amazon BestSeller

Amazon BestSeller 用于获取 Amazon 畅销榜数据。

  • 按分类 ID 获取指定榜单
  • 支持按地区抓取榜单结果
  • 支持从指定页开始连续抓取多页
  • 返回榜单页信息和商品列表数据

使用 XCrawl 获取 Amazon BestSeller 榜单

使用方式

curl -s -X POST 'https://run.xcrawl.com/v1/data' \
  -H 'Authorization: Bearer $XCRAWL_API_KEY'\
  -H 'Content-Type: application/json' \
  -d '{
    "engine": "amazon_bestseller",
    "location": "US",
    "category_list": ["111111"],
    "start_page": 1,
    "pages": 1
  }'

请求参数说明：

  • engine 固定为 amazon_bestseller
  • location 用于指定抓取地区
  • category_list 用于传入一个或多个分类 ID
  • start_page 和 pages 用于控制抓取页范围

响应示例

{
  "result": [
    {
      "content": {
        "url": "https://www.amazon.com/Best-Sellers/zgbs/x/1077068/?pg=1",
        "page": 1,
        "pages": 2,
        "results": [
          {
            "pos": 1,
            "url": "https://www.amazon.com/-/zh/dp/B098WVKF19/ref=zg_bs_g_1077068_d_sccl_1/136-8312013-1003251?psc=1",
            "asin": "B098WVKF19",
            "currency": "US$",
            "price": 129.99,
            "price_str": "US$129.99",
            "title": "REDTIGER 行车记录仪前置后置,4K / 2.5K 全高清行车记录仪,包括32GB 卡,内置Wi-Fi GPS,3.1 英寸 IPS 屏幕,夜视,170°广角,WDR,24小时停车模式 (F7NP)",
            "rating": 4.5,
            "ratings_count": 100
          },
          {
            "pos": 2,
            "url": "https://www.amazon.com/-/zh/dp/B0BRTSY1N9/ref=zg_bs_g_1077068_d_sccl_2/136-8312013-1003251?psc=1",
            "asin": "B0BRTSY1N9",
            "currency": "US$",
            "price": 29.98,
            "price_str": "US$29.98",
            "title": "DoHonest 婴儿车载摄像头 高清 1080P - 带夜视功能的后置汽车婴儿监视器,可调节视角,易于设置,防眩光显示,儿童和婴儿安全",
            "rating": 4.6,
            "ratings_count": 100
          }
        ]
      }
    }
  ]
}

参数说明

必填参数

参数类型说明
locationstring指定抓取地区。
category_listarray传入一个或多个 Amazon 畅销榜分类 ID。

可选参数

参数类型说明
start_pagenumber指定从第几页开始抓取。
pagesnumber指定连续抓取的页数。

参数补充说明

  • location 默认值为 US
  • location 支持多个地区值，例如 US、HK、CA、AD、AE
  • category_list 默认为空数组，数组元素应为分类 ID 字符串
  • start_page 默认值为 1
  • pages 默认值为 1

响应字段

响应数据位于 result[].content。

字段类型说明
urlstring榜单页面地址。
pagenumber当前页码。
pagesnumber榜单总页数。
resultsarray当前页商品列表。

商品字段

results[] 中每个元素包含以下字段：

字段类型说明
posnumber商品在榜单中的位置。
urlstring商品详情页地址。
asinstring商品 ASIN。
currencystring价格货币符号。
pricenumber商品价格。
price_strstring价格的字符串表示。
titlestring商品标题。
ratingnumber商品评分。
ratings_countnumber商品评分数量。