amazon/
shop

根据 amazon.com/shop 链接读取亚马逊达人店铺,返回达人资料、关联社媒账号、带商品数的清单、精选帖子,以及带价格的热门推荐。

Amazon Storefront API

店铺链接输入
商品清单
精选帖子
热门推荐
每次请求 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Amazon Storefront

Amazon storefront 是亚马逊达人计划成员在亚马逊上以自己的店铺名称经营的页面,达人把商品整理成清单和精选帖子,同时展示简介、头像、社媒链接和一排热门推荐。读取这个页面,就能知道达人是谁、还在哪些平台发布内容、推荐如何组织,以及当前主推哪些商品、价格多少。

Amazon Storefront API 主要特性

  • 达人资料与头部达人标识name、text 和 avatar_url 对应达人的显示名称、店铺简介和头像,is_top_creator 表示亚马逊是否将其标为头部达人。
  • 关联社媒账号social_urls 列出达人在店铺页头部关联的 TikTok、YouTube、Pinterest 等主页链接。
  • 带商品数的清单lists 返回店铺首页上的每个清单,包含标题、链接、封面图和 items_count,即清单内收录的商品数量。
  • 精选帖子curations 返回达人的精选帖子,包含标题、链接、封面图和 posts_count,即每篇帖子归集的商品数量。
  • 带价格的热门推荐trending_picks 返回店铺当前主推的商品,每件附店铺内商品链接、图片、按站点币种计的当前价格,以及页面显示的折扣。

Amazon Storefront API 参数

参数必填描述
url必填亚马逊达人店铺链接,格式为 https://www.amazon.com/shop/<name>;其他亚马逊站点的店铺链接同样适用。

如何使用 Amazon Storefront API

提交一个店铺链接,以单行结果读取整个店铺。

  1. 向 /v1/amazon/shop 发送 {"url": "https://www.amazon.com/shop/sydneydelrey"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
  3. 从 results.items 读取店铺;has_more 和 results.next_cursor 遵循通用分页规则,单行结果下为空。
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"}'

Amazon Storefront API 最佳使用场景

  • 筛选带货达人: 对比多个店铺的 is_top_creator、清单数量和 items_count,挑出在你所在品类里持续整理商品的达人。
  • 跟踪达人推荐变化: 每周重新读取同一店铺,比较清单标题、items_count 和 trending_picks,看哪些季节清单在扩充、哪些商品被推到前排。
  • 打通店铺与社媒账号: 借助 social_urls 把店铺和达人的 TikTok、YouTube、Pinterest 主页关联起来,让带货表现与社媒影响力落在同一条记录里。

Amazon Storefront API 使用建议

  • 随结果一起保存站点域名,因为 trending_picks.price 使用的是该站点的币种。
  • 以 id(取自链接的店铺名称)作为主键,多次读取同一达人时数据可以对齐。
  • 需要具体商品时,通过清单或精选帖子的 url 打开即可;items_count 和 posts_count 能提前告诉你它有多大。

除了 Amazon Storefront 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 Seller Info API — 根据已知卖家 URL 采集 Amazon 公开卖家身份、简介、网站、评分、反馈、地点、来源和采集时间字段。

探索其他平台

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

Amazon Storefront API — 常见问题

Amazon Storefront API 是一个根据店铺链接读取亚马逊达人店铺的 API。它返回达人资料、关联社媒账号、清单、精选帖子,以及带价格的热门推荐。

每次请求提交一个 amazon.com/shop/名称 形式的店铺链接。其他亚马逊站点的店铺,例如 amazon.co.uk/shop/名称,也按同样方式读取。

每次请求返回店铺首页展示的清单、精选帖子和热门推荐。每个清单和精选帖子都带链接和商品数,可以先看规模,再直接打开。

每条热门推荐包含店铺内的商品链接、商品图片、按站点币种计的当前价格,以及页面显示折扣时的折扣标签。

每次请求读取一个店铺,计 0.5 积分;店铺不存在时任务失败并全额退款。