tiktok/
search-live

按关键词搜索 TikTok 此刻正在直播的直播间,返回房间 ID、主播 ID、直播标题、当前在线人数、点赞数和开播时间,可直接用来查询直播带货商品。

TikTok Live Search API

关键词搜索
仅限正在直播
房间 ID 和主播 ID
每条结果 0.6 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

TikTok Live Search

TikTok 直播间就是一场正在进行的直播,带有房间 ID、标题、主播、实时在线人数、累计点赞和开播时间。按关键词匹配这些直播间,就能看到此刻有谁围绕某个话题开播、各场的观众规模有多大,这也是研究直播带货、物色主播和监测品牌直播热度的起点。

TikTok Live Search API 主要特性

  • 关键词进,在播直播间出query 接受一个关键词,返回搜索那一刻正在直播的直播间,每条的 status 都是 live。
  • 房间 ID 和主播 ID 在同一条记录里id 是房间 ID,author.id 是主播的用户 ID,正是 TikTok Live Shopping 查询该直播间商品所需的两个值。
  • 采集时刻的观众规模metrics.viewers_count 是直播间当前的人数,metrics.likes_count 是累计点赞,并附带 collected_at 时间戳。
  • 标题、开播时间、封面和直播页每条记录包含直播标题、published_at 中的开播时间、media 中的封面图、url 中指向主播直播页的链接,以及主播的账号名、显示名称和头像。

TikTok Live Search API 参数

参数必填描述
query必填用于查找直播间的关键词。
results_limit可选返回的直播间数量,取值 1 到 200,默认 20。

如何使用 TikTok Live Search API

用关键词搜索,读取此刻正在直播的直播间。

  1. 向 /v1/tiktok/search-live 发送 {"query": "deals", "results_limit": 20}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取直播间;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"deals","results_limit":20}'

# id 是房间 ID;author.id 是主播 ID,可用于 TikTok Live Shopping。

TikTok Live Search API 最佳使用场景

  • 摸排竞品的带货直播间: 用卖家在直播里常说的商品词搜索,例如 deals,再把每个直播间的 id 和 author.id 交给 TikTok Live Shopping,看购物袋里在卖什么。
  • 统计某个关键词下的直播热度: 按固定时间重复同一个 query,记录在播直播间的数量和各自的 viewers_count,看一个话题或品牌什么时候最能吸引直播观众。
  • 给合作主播建候选名单: 收集围绕你的话题正在开播的主播,按 viewers_count 和 likes_count 排序,再决定联系谁。

TikTok Live Search API 使用建议

  • 同一个领域多换几种说法搜索,并按 id 合并结果:每个关键词返回的直播间不同,同一场直播也可能同时命中多个关键词。
  • id 和 author.id 分开保存:id 对应一场直播,author.id 对应主播,要跨天跟踪某位主播请用 author.id。
  • 想长期盯某一个直播间的在线人数,不要反复搜索,改用 TikTok Live Room Info,传入该直播间的 room_id 和 user_id。

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

探索其他平台

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

TikTok Live Search API — 常见问题

TikTok Live Search API 是一个用于按关键词查找此刻正在直播的 TikTok 直播间的 API,results_limit 控制返回条数。每条记录包含房间 ID、主播 ID、直播标题、当前在线人数、点赞数、封面图和开播时间。

把结果里的 id 作为 room_id、author.id 作为 user_id,交给 TikTok Live Shopping。两个值必须来自同一条结果。

results_limit 取值 1 到 200,默认 20,匹配的直播间不足时会提前结束。每返回一个直播间计 0.6 积分,没有匹配结果的搜索不计费。

不能。只返回提交搜索时正在直播的直播间,每条的 status 都是 live,不返回往期直播。

直播间一直有人开播、有人下播,在播的集合会随时间变化。用 id 作为直播间的唯一标识,用 collected_at 记录每次采集的时间。

请求只有 query 和 results_limit 两个参数。拿到结果后,按 metrics.viewers_count 自行筛选。

本接口按关键词搜索。已知账号时请用 TikTok User Live,它接收 usernames,返回每个账号的直播状态。