Amazon Scraper 快速开始

使用 cURL 请求单个 Amazon 商品并读取其结构化结果。本演练使用了 Product API 参考 中的请求示例。

开始之前

你需要一个 Scrapeless 账户、一个有效的 API key 以及 cURL。请从 Scrapeless 控制台 获取你的 key。

该示例使用了 API 参考中的商品 URL。你可以将其替换为你想要检索的 Amazon 商品 URL。商品的可用性和返回的值可能会发生变化。

1. 发送请求

将 YOUR_API_KEY 替换为你的 key：

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.amazon",
  "input": {
    "type": "product",
    "url": "https://www.amazon.com/dp/B0BQXHK363",
    "zip_code": ""
  }
}'

请求体选择了 Amazon actor，将 type 设为 product，并提供了商品 url。空的 zip_code 与官方示例一致；当你需要该位置的配送信息时，请提供邮政编码。

2. 读取已完成的结果

HTTP 200 表示任务已完成。以下是已发布的 Product 响应示例的字段子集，并非一次新的抓取结果：

{
  "asin": "B0BQXHK363",
  "availability": "In Stock",
  "final_price": "$44.99",
  "rating": "4.0",
  "reviews_count": "115"
}

本示例中的价格、评分和评论数量均为字符串。读取载荷时请保留返回的类型，如果你的应用需要数值，请显式进行转换。完整示例中的其他字段包括 title、images 和 variations。

3. 检索仍在处理中的任务

HTTP 201 响应会返回一个任务 ID。API 参考中显示：

{
  "message": "task in progress",
  "taskId": "a8af123c-0f81-477d-a2e7-c57ad18fe54a"
}

在此请求中，请使用你自己响应中的 ID，而不是示例 ID：

curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

如果任务仍在处理中，请按照 Results and Polling 继续操作。请使用有上限的重试策略，而不是反复提交相同的商品请求。

如果请求失败

请同时检查 HTTP 状态码和响应体。Product 参考中包含一个 400 示例，其 code: 20500、message: "scraping failed"。请检查 key、商品 URL 和 JSON 输入。对于速率限制和服务器错误，请遵循通用轮询指南。

后续步骤

继续查看 Endpoints，了解 Seller、Keyword search 和 Rufus 请求。查看 Product API 参考 以获取完整的已发布示例。