Amazon 公开数据 API
从受支持的 Amazon 站点搜索公开商品，并采集标准化的商品详情、畅销榜、评价和卖家资料记录。
可用的 Amazon API
根据公开数据需求使用 Product Search、Product Detail、Best Sellers、Reviews 或 Seller Info。
可以获取哪些 Amazon 数据？
SocQ 从受支持的 Amazon 公开输入返回标准商品、评价和卖家记录；公开来源没有可用值时，相应字段会保留为空。
商品身份与内容
获取可用的商品 ID、标题、描述、公开 URL、平台与资源标识，以及采集时间。
卖家与价格信息
在来源提供可用值时，将标准卖家对象和价格字段与发现的商品一同返回。
可见口碑指标
将可用的评分、评论数和销量作为时间点观测值使用，不把缺失值误写为零。
商品媒体
获取可用于商品目录、审核队列和后续视觉处理的标准媒体对象。
SocQ 与直接处理页面的区别
SocQ 为受支持的 Amazon 公开数据提供带鉴权的任务流程和标准结果结构。直接处理页面时，请求编排、解析、存储、分页和结构维护均由应用自行承担。
| 能力 | SocQ | 直接处理页面 |
|---|---|---|
| 起始输入 | 搜索词或受支持的公开 Amazon URL | 页面 URL 与应用自定义抓取逻辑 |
| 执行模式 | 带状态轮询的异步任务 | 由应用自行定义和运行 |
| 商品结构 | 标准化商品记录 | 页面特定结构与自定义解析 |
| 已存结果读取 | 游标分页结果 | 应用自建存储与分页 |
Amazon API 如何工作
Amazon 各接口先执行异步任务，再通过游标分页读取结果。
1. 提交接口输入
根据所选接口提交搜索词、商品 URL、分类 URL 或卖家 URL，并保存 task_id。
2. 跟踪处理状态
轮询 /v1/tasks/{task_id}，直到处理成功或任务报告失败。
3. 获取商品记录
读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor 获取所有已保存记录。
使用 SocQ API key 鉴权，提交公开分类榜单 URL，并跟踪异步任务直到获取商品结果。
curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics"],"results_limit":3}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor常见 Amazon API 使用场景
分类选品研究
为指定的分类研究范围创建选定 Best Sellers 页面上可见商品的有界快照。
候选商品补充
为分类页中发现的商品补充标题、描述、卖家、价格、媒体和公开链接。
交易指标比较
在保留采集时间的同时，比较标准商品中可用的价格、评分、评论数和销量。
限制与公开数据政策
Amazon 结果是来自受支持公开页面的时间点记录。此接口不会访问客户账户、私有数据、购物车、订单、库存系统或卖家管理功能。
- 受支持的站点为 amazon.com、amazon.co.uk、amazon.de、amazon.fr、amazon.es、amazon.it、amazon.ca、amazon.com.au、amazon.in 和 amazon.co.jp，并支持这些域名的子域名。
- 请使用公开 Best Sellers 或分类榜单页面；通过域名校验的其他 Amazon 页面不一定包含受支持的商品列表。
- results_limit 默认为 100，接受 1 至 2,000，并限制任务内所有 URL 合计保存的唯一结果总数。
- 稳定响应不包含 Best Sellers 排名字段。
- 公开来源没有可用值时，商品 ID、内容、卖家、价格、评分、计数、媒体、URL 和发布时间可以为空。
Amazon API 常见问题
Amazon API 是什么？
Amazon APIs 用于搜索商品，并从受支持的 Amazon 公开输入采集标准商品、评价和卖家记录。
目前提供哪些 Amazon endpoint？
目前提供 Product Search、Product Detail、Best Sellers、Reviews 和 Seller Info，均使用统一异步任务流程。
可以一次采集多个分类 URL 吗？
可以，但 results_limit 是整个任务共享的总上限，并非为每个 URL 分别设置的限制。
SocQ 会返回商品排名吗？
不会。rank 不属于稳定商品结构，请使用可用的身份、卖家、价格、口碑、销量、媒体、来源和时间字段。
Amazon 商品字段可能缺失吗？
可能。标准商品字段均可为空，公开记录没有可用值时应保留缺失状态。
Best Sellers endpoint 如何计费？
每条成功返回的标准商品收费 0.15 积分。空结果不产生结果费用，任务结算时会退还未使用的预扣积分。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Douyin API
获取公开账号和视频，搜索视频，采集一页评论或创作者视频，并查询已知直播间。
Instagram API
通过统一异步流程查询已知 username 或发现公开主页，并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。
YouTube API
通过统一异步流程采集受支持的公开 YouTube 频道资料、视频详情、频道视频、评论、Shorts、关键词与话题标签结果和可用字幕。
X API
获取公开账号、关注者与关注列表、帖子、回复、引用帖、转发用户、搜索结果和当前趋势，用于研究和监测。
Facebook API
采集公开 Facebook Page、帖子、群组帖子、评论、关键词匹配活动和可用视频字幕，获得标准化身份、内容、来源、格式、地点、媒体、reaction、出席和互动字段。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。