amazon/
best-sellers

通过公开 Amazon Best Sellers URL 采集商品,返回标题、卖家信息、价格、可见口碑指标和媒体,并整理为标准化记录。

Amazon Best Sellers API

分类页 URL 输入
标准商品记录
每条结果 0.15 积分
每条结果 0.15 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Amazon Best Sellers

Amazon Best Sellers 页面按分类展示公开可见商品,并可能提供商品标题、卖家信息、价格、评分、评论数、销量、媒体、来源链接和观测时间。SocQ 将指定榜单 URL 转换为标准商品记录,可用于分类研究、选品比较和可重复的电商数据流程。

Amazon Best Sellers API 主要特性

  • 多区域分类 URL 采集在一个异步任务中提交一个或多个受支持 Amazon 站点上的公开 Best Sellers 或分类榜单 URL。
  • 标准商品身份信息获取可用的商品 ID、标题、描述、来源 URL、平台与资源标识,以及采集时间等稳定字段。
  • 交易与口碑上下文将可用的卖家信息、价格、评分、评论数和销量保存在明确字段中,减少下游解析页面结构的工作。
  • 适合媒体处理的记录每条商品记录可携带标准媒体对象,便于目录构建、审核队列、数据补充和后续视觉分析。

Amazon Best Sellers API 参数

参数必填描述
urls必填必填的 Amazon 引用列表,解析后的主机名必须属于受支持区域站点或其子域名,且路径必须包含 /zgbs/ 或 /gp/bestsellers/。接受任意带主机名的 scheme 和协议相对引用。
results_limit可选可选的 1 至 2,000 整数,默认为 100,用于限制所有输入 URL 合计保存的唯一商品记录总数。

如何使用 Amazon Best Sellers API

提交已知的公开 Best Sellers URL,跟踪异步任务,并分页读取标准商品记录。

  1. 准备一个或多个位于受支持 Amazon 站点上的公开 Best Sellers 或分类榜单 URL。
  2. 将 urls 和可选的 1 至 2,000 整数 results_limit 提交到 /v1/amazon/best-sellers,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或返回失败。
  4. 读取 data.results.items,并在 has_more 为 true 时继续提交 next_cursor。
curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/Best-Sellers-Books/zgbs/books"],"results_limit":3}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items,并在 has_more 为 true 时继续使用 next_cursor

Amazon Best Sellers API 最佳使用场景

  • 分类商品快照: 将选定 Best Sellers 页面整理为有界商品清单,并保留来源链接和采集时间,形成范围明确的研究数据集。
  • 价格与口碑比较: 直接比较结果中的可用价格、评分、评论数和销量,减少下游处理不稳定页面结构的成本。
  • 商品发现结果补充: 为分类页中发现的候选商品补充标题、卖家信息、描述、媒体和公开商品 URL。

Amazon Best Sellers API 使用建议

  • 使用受支持 Amazon 区域站点上路径包含 /zgbs/ 或 /gp/bestsellers/ 的引用;其他 Amazon 路径会在创建任务前被拒绝。
  • results_limit 作用于整个任务,而不是每个输入 URL,请根据合并后的批次规模设置该值。
  • 任务结果使用独立的游标分页视图,请持续使用 next_cursor,直到 has_more 变为 false。
  • 将 ID、描述、卖家、价格、评分、计数、媒体、URL 和发布时间视为可空字段,不要用零或空对象替代缺失值。
  • 为每条记录保留 collected_at;需要时间点对比时应另行调度采集,因为此接口不会建立连续数据流。

除了 Amazon Best Sellers API,需要其他类型的 Amazon 公开数据时,可以使用以下 API。

  • Amazon Product Details API — 通过已知 Amazon URL 采集商品详情,返回标题、描述、卖家、价格、评分、评价数、已售数量和媒体字段。
  • Amazon Product Search API — 按商品短语搜索受支持的 Amazon 站点,返回可用的标准化商品、卖家、价格、评分、评价数、已售数量、媒体和来源字段。
  • Amazon Reviews API — 通过受支持的 Amazon 商品 URL 采集公开评价,返回文本、评分、作者、商品引用、时间和媒体。
  • Amazon Seller Info API — 根据已知卖家 URL 采集 Amazon 公开卖家身份、简介、网站、评分、反馈、地点、来源和采集时间字段。
  • Amazon Storefront API — 根据店铺链接读取亚马逊达人店铺,包含达人资料、关联社媒账号、带商品数的清单、精选帖子,以及带价格的热门推荐。

探索其他平台

还可以将 Amazon 数据与其他已支持社交平台的公开数据结合使用。

Amazon Best Sellers API — 常见问题

Amazon Best Sellers API 是一个用于从公开 Amazon Best Sellers 或分类榜单 URL 采集商品并生成 SocQ 标准商品记录的 API。

urls 数组接受解析后主机名属于受支持 Amazon 区域站点或其子域名、且路径包含 /zgbs/ 或 /gp/bestsellers/ 的引用。接受任意带主机名的 scheme 和协议相对引用。

稳定商品响应不包含 rank 字段。标准记录聚焦于可用的商品身份、内容、卖家、价格、评分、评论数、销量、媒体、URL 和时间字段。

results_limit 默认为 100,接受 1 至 2,000 的整数,并限制整个任务中所有输入 URL 合计保存的唯一记录总数,不会为每个 URL 单独分配额度。

轮询 /v1/tasks/{task_id},任务成功后读取 data.results.items,并在 has_more 为 true 时继续请求返回的 next_cursor。结果页的 limit 只控制读取分页,不控制采集量。

公开可见性、页面内容、供应商输出、标准化、去重和任务级 results_limit 都可能减少最终结果数。成功任务也可能不包含商品记录。

每条成功返回的标准商品记录收费 0.15 SocQ 积分。任务先按 results_limit 预留积分,省略时按 100 条预留,再按实际返回数量结算并退还未使用积分;空结果不产生结果费用。