amazon/
seller-info

将已知 Amazon 公开卖家主页 URL 转换为标准化卖家身份、简介、网站、评分、反馈、地点、来源和采集时间字段。

Amazon Seller Info API

卖家主页详情
多站点支持
每个 URL 至多一条
每条结果 0.15 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Amazon Seller Info

Amazon 卖家主页可能展示卖家名称、公开简介、评分、反馈总数、网站和地点信息。SocQ 根据已知卖家 URL 采集当前可见字段并使用固定 seller 结构返回,私密字段、页面未展示字段、站点特有字段以及采集时无法获得的字段保留为 null,不会推断补全。

Amazon Seller Info API 主要特性

  • 按已知卖家 URL 采集提交一个或多个公开卖家主页 URL,支持美国、英国、欧洲、加拿大、澳大利亚、印度和日本等十个 Amazon 站点。
  • 稳定卖家身份结构以固定结构返回卖家 ID、公开 URL、卖家或企业名称、简介、关联网站和采集时间。
  • 公开信誉信号在 Amazon 页面提供相应值时保留来源报告的 rating 和 feedback_count,不计算或填充缺失指标。
  • 站点地点上下文保存可用的地点名称、城市、地区、国家、经纬度,同时允许每个选填地点字段为 null。

Amazon Seller Info API 参数

参数必填描述
urls必填必填的非空 Amazon 公开卖家引用数组。解析后的 hostname 必须属于受支持的市场或其子域名;接受带 hostname 的任意 scheme 及协议相对引用。本详情接口应使用卖家主页路径。

如何使用 Amazon Seller Info API

提交 Amazon 公开卖家主页 URL,跟踪异步任务,再从分页任务结果读取标准化卖家记录。

  1. 从受支持 Amazon 站点复制一个或多个公开卖家主页 URL。
  2. 将 urls 数组 POST 到 /v1/amazon/seller-info,并保存返回的 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/seller-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/sp?seller=A2L77EE7U53NWQ"]}'

# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取标准化卖家记录

Amazon Seller Info API 最佳使用场景

  • 卖家身份映射: 将准备好的卖家主页 URL 列表解析为一致的卖家 ID、名称、公开 URL、网站和站点上下文。
  • 信誉时间点快照: 记录公开评分、反馈总数和 collected_at,用于多次采集对比,不将其当作实时数据流。
  • 站点供应商审核: 建立审核队列,将公开卖家简介、网站、地点和反馈信号持续关联到来源主页 URL。

Amazon Seller Info API 使用建议

  • 优先提交 /sp?seller={seller_id} 形式的规范卖家主页链接;商品页和搜索页虽可能通过域名校验,但不是卖家详情输入。
  • 不要发送 results_limit。后端会为每个 URL 创建一个详情输入,并将保存结果上限设为非空 URL 数量。
  • 每个通过校验的 URL 可能返回零条或一条卖家记录,因此页面不可用或来源无结果时,result_count 会小于 URL 数量。
  • 将 rating 和 feedback_count 视为来源报告的时间点快照,多次采集对比时结合 collected_at。
  • 地点字段和 website 均为选填;不要根据空值或公开主页信息推断法律所在地、所有权或认证状态。

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

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

探索其他平台

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

Amazon Seller Info API — 常见问题

Amazon Seller Info API 是一个基于 URL 的详情接口,用于将 Amazon 公开卖家主页字段采集为标准化 seller 结构。它不访问私密 Seller Central 账号数据。

运行时校验接受美国、英国、德国、法国、西班牙、意大利、加拿大、澳大利亚、印度和日本 Amazon 域名及其子域名。

不一定。每个非空 URL 会成为一个详情输入,最多保存一条卖家记录;页面不可用、来源拒绝或返回空数据时可能没有结果。

不使用。results_limit 不是允许的请求字段,provider 会为每个 URL 接收一条详情记录。任务结果接口仍可通过 limit 和 next_cursor 对已保存记录分页。

每条成功返回的卖家记录消耗 0.15 SocQ 积分。请求先按每个 URL 预留 0.15 积分,再按实际 result_count 结算;成功但结果为空时基础费用为 0,未使用的预留积分会退回。