Amazon Scraper 接口端点

本页面上的所有操作均使用 scraper.amazon actor。通过 input.type 选择操作，并提供其对应的输入参数。

请求与身份验证

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

将 YOUR_API_KEY 替换为您的 Scrapeless API 密钥。发送一个包含 actor 和 input 的 JSON 对象。

选择操作

操作	`input.type`	下方使用的输入参数
商品	`product`	`url`, `zip_code`
卖家	`seller`	`url`, `zip_code`
关键词搜索	`keywords`	`keywords`, `page`, `domain`, `zip_code`
Rufus	`rufus`	`keywords`, `domain`

商品

提供亚马逊商品 URL。商品架构要求提供 url；zip_code 用于提供配送位置信息。

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": ""
  }
}'

发布的响应包含 asin、title、availability、final_price、rating、reviews_count、images 和 variations。有关简化的响应示例，请参阅 快速入门。

商品 API 参考文档

卖家

提供卖家页面 URL。包含 zip_code：卖家架构将其标记为必填项，且其请求示例中使用空字符串。

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": "seller",
    "url": "https://www.amazon.com/sp?seller=A2XZ7JICGUQ1CX",
    "zip_code": ""
  }
}'

卖家参考文档将成功响应定义为 JSON 对象，但未提供字段级架构或示例。在应用程序中映射卖家字段之前，请先检查返回的响应数据。

卖家 API 参考文档

关键词搜索

在 keywords 中提供搜索文本。使用 page 选择搜索结果页。以下示例遵循文档中记录的数字页码值，并使用 domain: "com" 表示 Amazon.com；它省略了可选的分类过滤器。

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": "keywords",
    "keywords": "Iphone+14+Pro+512GB",
    "page": 1,
    "domain": "com",
    "zip_code": ""
  }
}'

输入参数	用途
`keywords`	搜索关键词；操作架构要求必填。
`page`	搜索结果页码。
`domain`	亚马逊域名设置；官方示例使用 `com`。
`department`	可选的分类别名，对应亚马逊的 `i` 查询参数。
`zip_code`	用于配送信息的邮政编码。

发布的响应包含 keyword、page、result、total_results_count 和 url。商品条目出现在 result.organic 下。响应示例使用的查询和页码与请求示例不同，因此应将其用于理解字段结构，而非预测确切结果。

亚马逊参数指南指定 page 为整数值，且请求示例使用 1；但生成的操作架构当前将 page 标记为字符串。本指南遵循参数指南和请求示例。

关键词搜索 API 参考文档

Rufus

将 type 设置为 rufus。操作架构要求 keywords 和 domain 均为必填项。请使用完整的亚马逊域名（例如 www.amazon.es），而不是关键词搜索示例中使用的 com 格式。

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": "rufus",
    "keywords": "macbook",
    "domain": "www.amazon.es"
  }
}'

发布的响应包含：

字段	API 示例中显示的内容
`html`	包含事件记录和 HTML 片段的原始内容。
`metadata`	包含 `type` 和 `rawUrl`。
`result.user_query`	查询文本。
`result.products`	为该查询返回的商品条目。
`result.related_questions`	相关问题。
`result.sources`	数据来源，该字段可能不会在每次响应中返回。其可用性取决于商品和提示词。

操作架构还列出了 is_sse_data、is_get_question 和 asin，但未解释其行为。请以上述文档中的请求作为起点。

Rufus API 参考文档

处理任务结果

HTTP 200 响应包含已完成的结果。HTTP 201 响应表示处理仍在进行中；请保存其 taskId，并使用以下请求检索该任务：

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

将 YOUR_TASK_ID 替换为您的请求返回的 ID。有关轮询间隔和重试限制，请参阅结果与轮询。

请同时检查错误响应体和 HTTP 状态码。400 响应可能包含 code: 20500 和 message: "scraping failed"；这并非成功的数据响应。重试前请检查目标地址和请求输入参数。

参数参考

使用亚马逊 API 参数获取分类别名及其他文档记录的输入参数。根据所选的 type 解析结果；商品、关键词搜索、卖家和 Rufus 并不共享统一的字段布局。

快速入门介绍