加入 Amazon Influencer Program 的创作者会在 amazon.com/shop/<name> 开设店铺。他们把商品整理成清单(idea list)和精选帖子,关联自己的社交账号,并突出展示热门推荐。对联盟营销或网红合作团队来说,这个页面能回答很多实际问题:创作者是谁、还在哪些平台发内容、这一季在推荐什么、每个清单有多大。
SocQ 于 2026-11-17 上线了 Amazon Storefront API,把一个店铺作为一条结构化记录返回。本文介绍请求方式、返回字段、价格,以及如何把它放进创作者调研流程。
快速回答: 把一个店铺链接放进
url,发送到POST /v1/amazon/shop。轮询GET /v1/tasks/{task_id}直到任务成功,然后从data.results.items读取一行,其中包含创作者资料、social_urls、lists、curations和trending_picks。每次请求 0.5 积分($0.0025)。
接口返回什么
1 SocQ 积分 = $0.005。
| 接口 | 返回内容 | 价格 |
|---|---|---|
| Amazon Storefront API(Amazon 创作者店铺) | 每个店铺一行:创作者名称、简介、头像、顶级创作者标记、关联社交主页、带商品数的清单、带商品数的精选帖子,以及带价格的热门推荐 | 每次调用 0.5 积分($0.0025) |
返回的这一行覆盖店铺首页的清单、精选帖子和热门推荐。店铺不存在时任务失败并退款,因此失效链接不会产生费用。
鉴权与异步任务流程
所有 SocQ 请求都使用 API Key 鉴权,提交、任务状态和结果请求使用同一个请求头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
每次采集都作为后台任务运行:
submit -> task_id -> queued -> running -> succeeded
\-> failed
提交响应中包含 data.task_id 和 data.status。用这个 ID 轮询任务:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
当 status 为 succeeded 时,响应会在 data.results.items 中带上第一页标准化结果。limit 默认 50,最大 500;如果 has_more 为 true,把 results.next_cursor 作为 cursor 传入。任务处于 queued、running 或 failed 时,接口只返回任务元数据,不含 results。
在提交请求体中加入可选的 callback_url,任务结束后 SocQ 会发送一次带任务摘要的 POST;结果记录仍通过 GET /v1/tasks/{task_id} 读取。客户端超时不会取消任务,请用同一个任务 ID 继续查询,而不是重新提交并重复付费。402 表示积分不足;429 表示 API Key 触发了频率或积分限制。
请求一个店铺
唯一的输入是 url,即一个 amazon.com/shop/<name> 格式的店铺链接。其他 Amazon 站点同理。
curl -X POST "https://api.socq.ai/v1/amazon/shop" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.amazon.com/shop/sydneydelrey"
}'
每次请求只接收一个链接。要读取一批店铺,就为每个链接各提交一个任务,把每个 task_id 和对应输入一起保存,分别轮询。
理解店铺记录
下面是文档示例结果的精简版:
{
"id": "sydneydelrey",
"platform": "amazon",
"resource": "shop",
"type": "storefront",
"url": "https://www.amazon.com/shop/sydneydelrey",
"name": "sydney del rey",
"is_top_creator": true,
"social_urls": [
"https://vm.tiktok.com/ZTFrowSpg/",
"https://www.youtube.com/channel/UCWvW1JOQ-nsAinO1jLFgrVA",
"https://www.pinterest.com/sydneydelrey"
],
"lists": [
{
"title": "Holiday home goods",
"url": "https://www.amazon.com/shop/sydneydelrey/list/XYAIGEFWJGML?tag=sydneybertonc-20",
"items_count": 107
}
],
"curations": [
{
"title": "f/w fit try ons",
"url": "https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae",
"posts_count": 109
}
],
"trending_picks": [
{
"url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FCLQD6BN?showRelatedPost=true&tag_override=sydneybertonc-20",
"price": 24.99,
"discount": null
}
]
}
按用途分组的字段:
- 创作者身份:
id(链接中的店铺名称)、name、text(创作者写的店铺简介)、avatar_url,以及is_top_creator,表示 Amazon 是否把该创作者标记为顶级创作者。 - 跨平台触达:
social_urls,店铺上展示的社交主页链接。 - 目录结构:
lists含title、url、image_url和items_count;curations含title、url、image_url和posts_count(精选帖子中的商品数)。 - 当前推广:
trending_picks含url、image_url、以该站点货币计价的price,以及展示时才有的discount。
每一行还带有 collected_at,即 SocQ 采集该记录的时间。价格会变化,保存价格时请一并保存这个时间戳。完整字段表见 Amazon 创作者店铺文档。
适用场景
筛选联盟合作伙伴。 团队成员打开店铺之前,is_top_creator、清单数量和每个清单的 items_count 就能快速说明这个店铺有多活跃。
跟踪创作者的推荐。 定期重新读取店铺,对比两次之间的清单标题、数量和热门推荐,就能看出创作者这一季在推什么。
把店铺和创作者的社交账号关联起来。 social_urls 给出创作者关联的 TikTok、YouTube 或 Pinterest 主页。把它们交给 创作者 API 查找公开商务邮箱,或交给各平台的主页接口获取粉丝数。
商品调研。 热门推荐指向具体商品。要获取完整商品数据、评论或类目排名,可使用 SocQ 的其他 Amazon 接口,例如 Amazon Product Details API 和 Amazon Best Sellers API。它们与 Amazon 官方 API 的对比见 Amazon Product Advertising API 替代方案。
生产环境建议
- 统一链接格式。 每个创作者只保留一个规范的
amazon.com/shop/<name>链接,避免为同一个店铺付两次费。 - 把结果当作首页快照。 清单、精选帖子和热门推荐都是店铺首页上展示的内容。数量以
collected_at时刻为准。 - 单独处理失败。 店铺不存在时任务失败并退款。把它标记为已失效,不要反复重试。
- 预算很好算。 每个店铺 0.5 积分,1,000 个店铺共 500 积分,即 $2.50。
常见问题
什么是 Amazon Storefront API?
这是 SocQ 的一个接口,读取一个 Amazon 创作者店铺(amazon.com/shop/<name>),把创作者资料、关联社交账号、清单、精选帖子和热门推荐作为一条结构化记录返回。
amazon.com 以外的站点能用吗?
能。文档说明其他 Amazon 站点同理:在 url 中传入该站点的店铺链接即可。trending_picks 中的价格使用该站点的货币。
会返回每个清单里的所有商品吗?
不会。返回的这一行覆盖店铺首页:每个清单的标题、链接、封面图和 items_count,每个精选帖子的商品数,以及当前的热门推荐。它不会展开每个清单的全部商品。
店铺不存在也收费吗?
不收费。店铺不存在时任务失败并退款。请求成功时每次 0.5 积分($0.0025)。
能在一个请求里发送多个店铺吗?
请求只接收一个 url。请为每个店铺分别提交任务,并分别跟踪各自的 task_id。