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
提交一个店铺链接,以单行结果读取整个店铺。
- 向 /v1/amazon/shop 发送 {"url": "https://www.amazon.com/shop/sydneydelrey"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 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 能提前告诉你它有多大。
相关 API
除了 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 公开卖家身份、简介、网站、评分、反馈、地点、来源和采集时间字段。