简体中文

English

简体中文

English

Amazon Product Search

Amazon Product Search 用于根据关键词获取 Amazon 商品搜索结果。

  • 按关键词搜索 Amazon 商品
  • 支持按地区获取对应结果
  • 支持分页抓取搜索结果
  • 返回商品列表和筛选项信息

使用 XCrawl 获取 Amazon 商品搜索结果

使用方式

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

请求参数说明：

  • engine 固定为 amazon_search
  • keyword 用于指定搜索关键词
  • location 用于指定搜索地区
  • start_page 和 pages 用于控制抓取页范围

响应示例

{
  "result": [
    {
      "content": {
        "search_url": "https://www.amazon.com/s?k=shoe",
        "keyword": "shoe",
        "page": 1,
        "pages": 7,
        "products": [
          {
            "asin": "B0XXXXX",
            "title": "Example Product",
            "price": 39.99,
            "currency": "USD",
            "rating": 4.5,
            "reviews": 1200,
            "url": "https://www.amazon.com/..."
          }
        ],
        "refinements": {
          "Brands": [
            {
              "name": "Nike",
              "value": "n:7141123011,p_123:234394"
            }
          ]
        }
      }
    }
  ]
}

参数说明

必填参数

参数类型说明
locationstring指定搜索地区。
keywordstring指定搜索关键词。
start_pagenumber指定从第几页开始抓取。
pagesnumber指定连续抓取的页数。

参数补充说明

  • location 默认值为 US
  • location 支持多个地区值，例如 US、HK、CA、AD、AE
  • keyword 默认值为空字符串
  • start_page 默认值为 1
  • pages 默认值为 1

响应字段

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

字段类型说明
search_urlstring搜索结果页地址。
keywordstring当前搜索关键词。
pagenumber当前页码。
pagesnumber搜索结果总页数。
productsarray商品列表。
refinementsobject搜索筛选项。

商品字段

products[] 中每个元素通常包含以下字段：

字段类型说明
asinstring商品 ASIN。
titlestring商品标题。
pricenumber商品价格。
currencystring价格货币。
ratingnumber商品评分。
reviewsnumber评论数量。
urlstring商品详情页链接。

筛选项字段

refinements 用于返回可进一步筛选搜索结果的条件，例如品牌、部门、卖家等。