AmazonAmazon 店铺Amazon 网红联盟营销API 指南

Amazon 店铺 API:读取创作者店铺、清单与热门推荐

一次 API 调用读取 Amazon 创作者店铺:资料、关联社交账号、带商品数的清单、精选帖子和带价格的热门推荐,每次 0.5 积分。

SocQ更新于 2026年11月19日阅读约 5 分钟

加入 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 替代方案。

生产环境建议

  1. 统一链接格式。 每个创作者只保留一个规范的 amazon.com/shop/<name> 链接,避免为同一个店铺付两次费。
  2. 把结果当作首页快照。 清单、精选帖子和热门推荐都是店铺首页上展示的内容。数量以 collected_at 时刻为准。
  3. 单独处理失败。 店铺不存在时任务失败并退款。把它标记为已失效,不要反复重试。
  4. 预算很好算。 每个店铺 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。

AMAZON API

使用公开的 Amazon 输入测试工作流

提交公开输入,获取带有可追溯来源上下文的标准化记录。

查看 Amazon API