跳转到主要内容
通过异步任务 API 搜索 eBay(ebay.com)的商品。发送 COMMERCE_SERP 并设置 site ebay,按商城的顺序获取搜索结果中的商品。COMMERCE_PRODUCT 不读取这家商城的商品页面。每次完成的搜索消耗 0.5 积分。

搜索

提交任务后,轮询 GET /v1/async/task/{id} 或通过 webhook 接收。参见异步任务。

参数

  • site:必填。值为 ebay。
  • query:必填。搜索词,1-500 个字符。
  • limit:可选整数,范围 1-40,默认 20。
  • country:可选。默认是商城所在国家 US。其他国家会以 422 REGION_UNSUPPORTED 拒绝。
仅接受上方列出的载荷字段。请省略 include:即使是 include: {},也会在冻结积分前返回针对 payload.include 的 422 VALIDATION_ERROR。

响应示例

结果字段

  • site、query 和 country 回显请求。returnedCount 是 products 中的商品数。
  • 每个商品包含 rank、productId、title 和 url。productId 是 eBay 商品编号。rank 遵循商城的默认排序,商城标为广告的商品会被跳过。
  • 搜索结果页显示时返回 price、rating、reviewCount 和 imageUrl。price 是以商品的 currency(ISO 4217)计的数字;不同规格分别定价时,取最低价。
  • rating 为五分制。像 999+ 这样的缩写评价数不会返回。
  • 每次搜索从商城搜索结果的第一页获取商品。

错误与计费

  • 没有返回任何商品的搜索以失败任务结束。
  • 只对完成的搜索计费,每次 0.5 积分。

相关