Amazon Product Search API

Amazon Product Search

主要特性

• 限定 Amazon 站点的查询将非空商品 query 与一个受支持的 Amazon domain 配对，明确本次请求面向的站点。
• 可控结果数量results_limit 可设为 1 至 2,000 的整数；采集在达到请求上限或没有更多来源记录时结束。
• 标准化商品身份获得统一的商品 ID、类型、来源 URL、标题、说明、发布时间和采集时间字段。
• 商业信息上下文直接使用可用的卖家、价格、评分、评价数、已售数量和媒体字段，无需解析各站点的搜索结果结构。

参数

如何使用

选择目标 Amazon 站点和具体商品短语，再提交一次异步请求。

1. 填写非空 query，提供受支持的 Amazon domain URL，并把 results_limit 设为 1 至 2,000。
2. 把请求 POST 到 /v1/amazon/product-search，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务进入 succeeded 或 failed 状态。
4. 任务成功后读取 data.results.items；has_more 为 true 时继续传入 next_cursor。

curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"wireless earbuds","domain":"https://www.amazon.com","results_limit":3}'

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

最佳使用场景

• 站点商品发现： 在一个受支持的 Amazon 站点中查找与品类、特征、品牌或购买意图短语匹配的公开商品。
• 报价比较： 对比返回商品中可用的价格数值、币种、格式化价格和卖家身份。
• 口碑筛选： 检查可用评分、评价数和已售数量，同时把缺失信号原样视为不可用。
• 商品目录补全： 使用标准化标题、说明、来源 URL、媒体、卖家和采集时间补全商品候选。

使用建议

• 为每个任务一起保存 query 和 domain，因为同一短语在不同 Amazon 站点可能得到不同结果。
• 按所需规模设置 results_limit：系统按该数量预留结果费用，完成后以实际返回记录结算。
• 成功任务包含多个已存储结果页时，持续使用 next_cursor，直到 has_more 为 false。
• 把缺失的卖家、价格、评分、评价数、已售数量或媒体视为不可用，不要转换为零或空身份。

相关 API