eBay Product Search 用于按关键词获取 eBay 商品搜索结果。

• 按关键词抓取 eBay 商品搜索结果
• 支持按地区发起请求
• 支持从指定页开始连续抓取多页结果
• 返回商品列表、分类信息和筛选项

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

使用方式

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

请求参数说明：

• engine 固定为 ebay_search
• location 用于指定请求地区
• keyword_list 用于传入一个或多个搜索关键词
• start_page 和 pages 用于控制抓取页码范围

响应示例

{
  "result": [
    {
      "url": "https://www.ebay.com/sch/i.html?_nkw=Coffee+Maker",
      "page": 1,
      "query": "Coffee Maker",
      "results": [
        {
          "title": "Keurig K-Classic Coffee Maker",
          "price": "59.99",
          "currency": "USD",
          "url": "https://www.ebay.com/itm/xxxxxxxxxxxx",
          "image": "https://i.ebayimg.com/images/..."
        }
      ],
      "categories": [
        {
          "name": "Home & Garden",
          "link": "https://www.ebay.com/sch/11700/i.html?_nkw=Coffee+Maker"
        }
      ],
      "refinements": {
        "Brand": [
          {
            "name": "Keurig",
            "link": "https://www.ebay.com/sch/i.html?_nkw=Coffee+Maker&Brand=Keurig"
          }
        ]
      }
    }
  ]
}

参数说明

必填参数

参数	类型	说明
location	string	指定请求地区。
keyword_list	array	传入一个或多个搜索关键词。
start_page	number	指定从第几页开始抓取。
pages	number	指定连续抓取的页数。

参数补充说明

• location 默认值为 US
• location 支持多个地区值，例如 US、HK、CA、GB、JP
• keyword_list 默认值为空数组，数组元素为搜索关键词
• start_page 默认值为 1
• pages 默认值为 1

响应字段

字段	类型	说明
url	string	抓取的 eBay 搜索页链接。
page	number	当前页码。
query	string	当前搜索关键词。
results	array	商品搜索结果列表。
categories	array	分类导航列表。
refinements	object	搜索筛选项。

结果项字段

results[] 中的结果项通常会包含商品标题、价格、货币、链接、图片，以及与商品卡片相关的其他信息。

分类字段

categories[] 中每一项通常包含以下字段：

字段	类型	说明
name	string	分类名称。
link	string	分类链接。

筛选字段

refinements 用于返回当前搜索结果页可用的筛选项，例如品牌、价格区间、商品状态、配送方式和购买方式。每个筛选组下的选项通常包含名称和对应链接。

上一页eBay Product Detail

下一页Google Events Search