amazon/
product-search

按商品短语搜索受支持的 Amazon 站点,返回标准化商品、卖家、价格、评分、评价数、已售数量和媒体字段。

Amazon Product Search API

商品搜索
站点范围
标准化记录
每条结果 0.15 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Amazon Product Search

Amazon Product Search 将商品短语和站点 URL 转换为标准化公开商品记录。来源提供相应数据时,每条结果可包含来源 URL、标题、说明、卖家、价格、评分、评价数、已售数量、媒体、发布时间和采集时间。

Amazon Product Search API 主要特性

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

Amazon Product Search API 参数

参数必填描述
query必填必填的非空商品关键词或短语。
domain必填必填的 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 及协议相对引用。
results_limit可选请求结果上限,可设为 1 至 2,000;省略时默认为 100。

如何使用 Amazon Product Search API

选择目标 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 Product Search API 最佳使用场景

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

Amazon Product Search API 使用建议

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

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

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

探索其他平台

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

Amazon Product Search API — 常见问题

Amazon Product Search API 使用商品 query 搜索一个受支持的 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 和协议相对引用。

query 和 domain 是必填的非空字符串。results_limit 为可选项,默认值为 100,并且必须是 1 至 2,000 的整数。

商品可包含 ID、平台、资源、类型、来源 URL、发布时间、采集时间、标题、说明、卖家、价格、评分、评价数、已售数量和媒体。仅在来源提供可用值时返回可空字段。

results_limit 是最大值。公开来源没有更多匹配记录时,采集会提前结束,因此成功任务也可能返回较少商品或没有商品。

轮询 /v1/tasks/{task_id},成功后读取 data.results.items;has_more 为 true 时使用 next_cursor 请求下一页任务结果。

每条成功返回的标准化商品消耗 0.15 SocQ 积分。请求按 results_limit 预留费用,省略时按 100 条预留;完成后按实际结果数结算并退回未使用积分,空结果不产生结果费用。