tiktok/
live-products

根据直播间 ID 和主播 ID 列出 TikTok 直播购物袋里的商品:标题、当前价格、已售数量、卖家 ID、商品链接和图片,最多一次读取 500 件。

TikTok Live Shopping API

房间 ID 和主播 ID
购物袋商品
最多 500 件商品
每条结果 0.1 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

TikTok Live Shopping

TikTok 直播购物袋是主播在直播中售卖的商品集合,袋里每件商品都有标题、带币种的价格、已售数量、卖家和图片。读取购物袋,就能知道这场直播在主推什么、开播期间这些商品怎么定价,以及哪些已经卖出了量。

TikTok Live Shopping API 主要特性

  • 购物袋里的每件商品传入 room_id 和主播的 user_id,直播间购物袋中的每件商品各返回一条记录,数量上限由 results_limit 决定,最高 500。
  • 价格含金额、币种和展示文本price.amount、price.currency 和 price.formatted 分别是数值、币种代码和观众看到的价格文本,例如 41.6、USD 和 $41.60。
  • 已售数量是整数sold_count 是 101600 这样的整数,可以直接排序和比较。
  • 商品链接、卖家 ID 和图片每条记录带有 url 中的商品页、seller.id 中的卖家 ID,以及 media 中带宽高的商品图。

TikTok Live Shopping API 参数

参数必填描述
room_id必填直播间的数字 ID,取自 TikTok Live Search 结果的 id。
user_id必填主播的 TikTok 数字用户 ID,取自同一条 Live Search 结果的 author.id。
results_limit可选返回的商品数量,取值 1 到 500,默认 100。

如何使用 TikTok Live Shopping API

先找到一场带货直播,趁直播还在进行时读取购物袋。

  1. 用购物关键词调用 TikTok Live Search,取一条结果的 id 和 author.id。
  2. 向 /v1/tiktok/live-products 发送 {"room_id": "7704767945901132575", "user_id": "7153432386608251946"}。
  3. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded,然后从 results.items 读取商品;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'

# 每条结果是一件商品,包含 title、price 和 sold_count。

TikTok Live Shopping API 最佳使用场景

  • 拆解竞品的直播购物袋: 从 Live Search 取到对手主播的 room_id 和 user_id,列出整个购物袋,看他们在跑哪些商品、什么价位。
  • 盯直播期间的价格变化: 每隔几分钟读取同一个直播间,按商品 id 对比 price.amount,抓住主播在直播里宣布的降价。
  • 找出购物袋里的爆款: 按 sold_count 给购物袋排序,看哪些商品已经卖出最多,再结合价格一起判断。

TikTok Live Shopping API 使用建议

  • 跨直播间比价前先看 price.currency,金额只有带上币种才有意义。
  • 两次读取之间用商品 id 对应同一件商品,变化的是 price.amount 和 sold_count 这类字段。

除了 TikTok Live Shopping API,需要其他类型的 TikTok 公开数据时,可以使用以下 API。

  • TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
  • TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
  • TikTok Comments API — 采集公开顶级评论、作者、互动、提及和创作者互动标记。
  • TikTok Videos API — 从视频 URL 获取创作者、文案、媒体、音乐、标签、提及和互动信息。
  • TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间,返回状态、主播信息、封面和受众计数。
  • TikTok Live Search API — 按关键词查找正在直播的直播间,返回主播、标题和当前在线人数。

探索其他平台

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

TikTok Live Shopping API — 常见问题

TikTok Live Shopping API 是一个用于按直播间的 room_id 和主播的 user_id 列出 TikTok 直播购物袋商品的 API。它返回每件商品的标题、价格、已售数量、卖家 ID、链接和图片。

调用 TikTok Live Search,把结果的 id 作为 room_id,author.id 作为 user_id。这两个值必须来自同一条结果。

results_limit 取值 1 到 500,默认 100,购物袋较小时会提前结束。每返回一件商品计 0.1 积分,500 件的完整购物袋共 50 积分。

该直播间的主播没有挂购物袋,或者直播已经结束。返回空结果不收费。

不能,请求购物袋时直播间必须正在直播。想留存商品清单,请在直播进行中读取并自己保存。

sold_count 是 TikTok 为该商品给出的已售数量,TikTok 没有给出时为 null。想看直播期间卖了多少,请在前后各读取一次购物袋再相减。