Amazon Seller Info API

Amazon Seller Info

主要特性

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

参数

如何使用

提交 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 读取标准化卖家记录

最佳使用场景

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

使用建议

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

相关 API