Amazon Best Sellers API

Amazon Best Sellers

主要特性

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

参数

如何使用

提交已知的公开 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

最佳使用场景

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

使用建议

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

相关 API