tiktok/
live-ranking

一次调用获取 TikTok 直播日榜:最多 99 位主播的排名、礼物积分、用户 ID、账号名、显示名称、粉丝数和主页链接,无需任何输入。

TikTok Live Ranking API

无需输入
最多 99 位主播
礼物积分
每次请求 0.5 积分
等待提交
等待提交

发送空请求后,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

TikTok Live Ranking

TikTok 直播日榜是当天直播主播的排行榜,按主播直播间收到的礼物计算出的分数排序,每个条目包含主播的名次、分数和粉丝数。看这份榜单,就能知道今天观众在支持哪些主播、前几名的位置如何变动,以及哪些体量不大的账号拿到的支持超出了粉丝规模所能解释的程度。

TikTok Live Ranking API 主要特性

  • 整份榜单,不用传参请求不需要任何输入,直接返回当前直播日榜,最多 99 位主播,每位都带有 rank。
  • 分数和粉丝量并排score 是基于礼物的排名分值,followers_count 是主播的粉丝总数,不必再查一次,就能对比获得的支持和受众规模。
  • 每一行都有主播身份author 提供主播的用户 ID、账号名、显示名称、主页链接和头像。

TikTok Live Ranking API 参数

可直接发送

此接口无需请求参数,直接发送空 JSON 对象即可。

{}

如何使用 TikTok Live Ranking API

提交一个空请求,读取排好名次的主播。

  1. 向 /v1/tiktok/live-ranking 发送 {}。
  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/live-ranking" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# 每条结果包含 rank、score、author 和 followers_count。

TikTok Live Ranking API 最佳使用场景

  • 盯一天里榜单的变化: 在固定时间点拉取榜单,把每位主播的 rank 和 score 画成曲线,看谁在爬升、名次什么时候洗牌。
  • 给经纪公司和品牌物色主播: 用 score 除以 followers_count,找出粉丝量不大、观众却送了很多礼物的主播,再列入签约或合作的候选名单。

TikTok Live Ranking API 使用建议

  • 每天固定在同一时间拉取:中午读到的分数和半夜读到的分数,覆盖的是同一天里不同的时间段。
  • 榜单本身不含直播状态。用 author.id 对应主播,再把他们的 usernames 交给 TikTok User Live,确认谁此刻正在直播。

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

  • TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
  • TikTok Followers List API — 采集公开粉丝列表中可见的标准化资料,并保留来源上下文和支持的指标。
  • TikTok Following List API — 采集 TikTok 账号公开可见的关注对象,返回标准化身份、简介、可见指标和来源账号信息。
  • TikTok User Live API — 按用户名查看账号是否正在直播,以及可获取的直播间信息。
  • TikTok Audience Demographics API — 按用户名查看创作者的粉丝来自哪些国家和地区,以及各自的占比。
  • TikTok Live Search API — 按关键词查找正在直播的直播间,返回主播、标题和当前在线人数。

探索其他平台

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

TikTok Live Ranking API — 常见问题

TikTok Live Ranking API 是一个用于读取 TikTok 直播日榜的 API,无需任何输入。它返回最多 99 位主播的排名、基于礼物的分数、用户 ID、账号名、显示名称和粉丝数。

score 是 TikTok 今天给主播排名所用的分值,依据是主播直播间收到的礼物。它是排名分数,不是任何币种的收入金额。

这个接口不支持。它不需要输入,只返回当前的直播日榜,需要历史数据的话,请自己保存每次拉取的结果。

名次会随着一天里礼物不断送出而变动。每次拉取整份榜单固定 0.5 积分,每小时拉一次,一天就是 12 积分。

不会。它排的是收到礼物的主播,每位主播只有名次、分数和个人信息,没有送礼观众的名单。