Amazon Product Details
Amazon 商品是公开目录中的条目，包含标识、标题、描述、卖家信息、价格、评分、评价数、已售数量和媒体等信息。这些字段可用于补全商品目录、比较选定条目、核对来源以及制作时间点商品报告。
主要特性
- 批量查询已知商品 URL在一个任务中提交一个或多个 Amazon URL，返回的标准化商品记录不会超过有效输入 URL 的数量。
- 商品身份、说明与媒体每条记录可包含商品标识与 URL、标题、描述、采集时间，以及可用的图片或视频引用。
- 卖家、价格与可见商品信号嵌套的卖家和价格对象与评分、评价数和来源报告的已售数量处于同一标准结构中，便于按字段处理。
- 支持多个 Amazon 站点URL 校验接受美国、英国、德国、法国、西班牙、意大利、加拿大、澳大利亚、印度和日本 Amazon 站点及其子域名。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的非空 Amazon 商品引用数组。解析后的 hostname 必须是 amazon.com、amazon.co.uk、amazon.de、amazon.fr、amazon.es、amazon.it、amazon.ca、amazon.com.au、amazon.in、amazon.co.jp 或其子域名；接受带 hostname 的任意 scheme 及协议相对引用。 |
如何使用
提交已知商品 URL，保存异步 task ID，并在任务成功后读取标准化商品记录。
- 使用 Bearer token 或 API Key，将 urls 数组 POST 到 /v1/amazon/product-detail。
- 保存返回的 task_id，并轮询 GET /v1/tasks/{task_id}，直到 status 变为 succeeded 或 failed。
- 任务成功后读取 data.results.items；仅在 has_more 为 true 时使用 next_cursor 读取下一页，不要重新提交商品任务。
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；仅在 has_more 为 true 时继续使用 next_cursor最佳使用场景
- 补全已知商品目录： 为现有 Amazon URL 集合补充商品标题、描述、卖家信息、价格、媒体、评分和数量字段。
- 比较时间点商品记录： 在同一采集时间下比较选定商品的标准化价格、币种、评分、评价数、已售数量和卖家字段。
- 核对商品来源： 结合标识、原始 URL、标题、描述、媒体引用和采集时间，复核已存目录引用与公开商品页。
使用建议
- 使用解析后 hostname 属于受支持 Amazon 站点的商品引用；主机名通过校验并不代表目标一定能解析为公开商品记录。
- 不要发送 results_limit，因为该接口会按提交 URL 数量固定供应端结果上限。
- 将卖家、价格、评分、评价数、已售数量、媒体、URL 和发布时间字段按可空值处理；任务成功但没有 items 时，不要生成占位商品。
- next_cursor 仅用于翻阅已存任务结果；继续查询同一 task ID，不要重复发起会计费的 POST。
相关 API
需要其他类型的 Amazon 公开数据时，可以使用以下 API。
- Amazon Best Sellers API — 从公开 Amazon Best Sellers 分类 URL 采集商品，返回标准化卖家、价格、口碑、销量、媒体、来源和时间字段。
- Amazon Product Search API — 按商品短语搜索受支持的 Amazon 站点，返回可用的标准化商品、卖家、价格、评分、评价数、已售数量、媒体和来源字段。
- Amazon Reviews API — 通过受支持的 Amazon 商品 URL 采集公开评价，返回文本、评分、作者、商品引用、时间和媒体。
- Amazon Seller Info API — 根据已知卖家 URL 采集 Amazon 公开卖家身份、简介、网站、评分、反馈、地点、来源和采集时间字段。