数据方法

tik.tools 如何采集
TikTok LIVE 数据

每个榜单是什么、多久刷新一次、地区如何对应国家、各套餐脱敏哪些内容及原因、我们保留多长的历史,以及我们的覆盖还有哪些空白。

数据从哪里来

tik.tools 读取 TikTok 在 App 中展示的 TikTok LIVE 排行榜和 LIVE 直播间:日榜、联赛榜、游戏榜、带货榜、热门 LIVE 和团队榜,以及榜上主播的公开 LIVE 直播间。榜单上的每个数字都是 TikTok 在我们采集那一刻显示的数值;除标注为预估值的数据外,tik.tools 不会调整、平滑或推算这些数字。

tik.tools 是独立服务,与 TikTok 或 ByteDance 没有任何关联。

榜单与刷新频率

每个榜单按各自的时间表重新采集。下方的间隔是我们请求新数据的频率;完整轮询所有地区可能会超过一个间隔,页面和 API 响应还可能额外有最多约一分钟的缓存。每个榜单页面都会显示数据的采集时间,引用数字时请一并注明该时间。

榜单排名内容刷新频率
主播日榜按地区统计主播当天收到的钻石每轮约 30 秒
单独国家榜TikTok 在某个分区内单独发布的单一国家日榜每 1 到 3 分钟
联赛分组按地区统计每周各联赛分组(A1 到 D5)中的主播每个分组约每 5 分钟
游戏榜按地区统计游戏主播总榜及各追踪游戏的分榜约每 2 分钟;直播状态约每分钟
直播带货榜按地区统计直播带货主播,周榜周期约每 2 分钟,每周重置后立即刷新
热门 LIVETikTok 当前在热门 LIVE 中推荐的直播间约每分钟
团队榜按地区统计团队排名约每 5 分钟
上升最快主播排名攀升最快的主播每 15 分钟
送礼用户榜按送出钻石统计的头部送礼用户,分日榜、周榜和月榜日榜每 5 分钟;周榜和月榜每 30 分钟
开播人数某地区当前正在直播的上榜主播数量约每 30 秒

日榜每天在各地区自己的重置时间重置一次(见下方各地区列表),因此日榜分数是当前榜单日的累计值。联赛分组每周一在该地区的重置时间重置。土耳其和中东和非洲 在 TikTok 上没有日榜;对这些地区我们显示小时榜,其联赛分组每日重置。

地区与国家

tik.tools 为 44 个 TikTok LIVE 地区提供排名。一个地区就是一个 TikTok 排名分区:TikTok 为一个国家或一组国家发布的单一日榜。主播所属地区是其参与排名的分区,而不是国籍。TikTok 不公布单个主播的国家,因此 tik.tools 也不会为主播指定国家。

除这些地区外,TikTok 还会在某些分区内为单个国家发布单独榜单。这些榜单在 TikTok 发布期间会显示在排行榜页面上,停止发布后即会移除。

地区榜单覆盖的国家每日重置
北美美属萨摩亚, 关岛, 北马里亚纳群岛, 美国本土外小岛屿, 美国, 波多黎各, 美属维尔京群岛UTC 04:00
加拿大加拿大UTC 04:00
巴西巴西UTC 04:00
墨西哥墨西哥UTC 05:00
拉丁美洲阿根廷, 玻利维亚, 智利, 哥斯达黎加, 厄瓜多尔, 几内亚, 危地马拉, 洪都拉斯, 尼加拉瓜, 巴拿马, 巴拉圭, 萨尔瓦多, 乌拉圭, 委内瑞拉UTC 05:00
哥伦比亚、秘鲁和多米尼加共和国哥伦比亚, 多米尼加共和国, 秘鲁UTC 05:00
牙买加牙买加UTC 08:00
澳大利亚和太平洋地区澳大利亚, 科科斯(基林)群岛, 库克群岛, 圣诞岛, 斐济, 密克罗尼西亚, 基里巴斯, 马绍尔群岛, 诺福克岛, 瑙鲁, 纽埃, 新西兰, 巴布亚新几内亚, 皮特凯恩群岛, 帕劳, 所罗门群岛, 托克劳, 汤加, 图瓦卢, 瓦努阿图, 瓦利斯和富图纳, 萨摩亚UTC 12:00
日本日本UTC 15:00
韩国韩国UTC 15:00
台湾台湾UTC 16:00
印度尼西亚印度尼西亚UTC 17:00
马来西亚马来西亚UTC 16:00
新加坡新加坡UTC 16:00
菲律宾菲律宾UTC 16:00
泰国泰国UTC 17:00
越南越南UTC 17:00
尼泊尔尼泊尔UTC 18:00
孟加拉国、不丹和马尔代夫孟加拉国, 不丹, 马尔代夫UTC 18:00
阿塞拜疆阿塞拜疆UTC 22:00
哈萨克斯坦哈萨克斯坦UTC 22:00
吉尔吉斯斯坦吉尔吉斯斯坦UTC 22:00
白俄罗斯白俄罗斯UTC 22:00
乌克兰乌克兰UTC 22:00
中亚亚美尼亚, 格鲁吉亚, 乌兹别克斯坦, 摩尔多瓦, 塔吉克斯坦, 土库曼斯坦UTC 22:00
德国及 DACH 地区奥地利, 德国, 列支敦士登UTC 22:00
瑞士瑞士UTC 22:00
伊比利亚半岛安道尔, 西班牙UTC 05:00
中欧捷克, 匈牙利, 斯洛伐克UTC 22:00
葡语国家安哥拉, 佛得角, 赤道几内亚, 几内亚比绍, 莫桑比克, 葡萄牙, 圣多美和普林西比UTC 22:00
法国法国, 法属圭亚那, 摩纳哥, 新喀里多尼亚, 法属波利尼西亚, 留尼汪, 法属南部领地UTC 22:00
比利时比利时UTC 22:00
荷兰荷兰UTC 22:00
英国刚果(金), 英国, 根西岛, 直布罗陀, 马恩岛, 泽西岛, 斯瓦尔巴和扬马延UTC 23:00
爱尔兰、波罗的海国家和马耳他爱沙尼亚, 爱尔兰, 立陶宛, 拉脱维亚, 马耳他UTC 23:00
意大利意大利, 圣马力诺UTC 23:00
瑞典瑞典UTC 22:00
北欧丹麦, 芬兰, 法罗群岛, 格陵兰, 冰岛, 挪威UTC 22:00
波兰波兰UTC 22:00
罗马尼亚罗马尼亚UTC 22:00
巴尔干阿尔巴尼亚, 波斯尼亚和黑塞哥维那, 保加利亚, 希腊, 克罗地亚, 黑山, 北马其顿, 塞尔维亚, 斯洛文尼亚UTC 22:00
土耳其土耳其每小时
中东和非洲阿拉伯联合酋长国, 巴林, 吉布提, 阿尔及利亚, 埃及, 伊拉克, 约旦, 科摩罗, 科威特, 黎巴嫩, 利比亚, 摩洛哥, 毛里塔尼亚, 阿曼, 巴勒斯坦领土, 卡塔尔, 沙特阿拉伯, 苏丹, 索马里, 突尼斯, 也门每小时
尼日利亚、加纳、肯尼亚和南非埃塞俄比亚, 加纳, 肯尼亚, 尼日利亚, 乌干达, 南非UTC 22:00

重置时间是该地区 TikTok 榜单最常翻新的整点,依据我们自己的采集历史测算。如有 TikTok 公布的实时倒计时,地区页面会显示出来。

各套餐脱敏哪些内容,以及原因

分数、排名和数量永远不会脱敏:每一行都保留真实排名和钻石数,因此所有套餐下的总数和名次都是准确的。不同套餐的区别在于某一行是否显示主播或送礼用户的名称。脱敏的名称显示为一串圆点加上名称的最后几个字符。

页面未开通解锁套餐时显示全名所需套餐
地区日榜显示前 10 名未开播主播的名称;正在直播的主播一律不显示名称Pro
全球总览名称脱敏Pro
联赛分组每个分组显示 1 位主播名称Ultra
游戏榜每个榜单显示 1 位主播名称Agency
直播带货榜显示 1 位主播名称Agency
热门 LIVE显示前 10 名未开播主播的名称Agency
涨幅榜显示 3 位主播名称Agency
送礼用户榜显示钻石数和数量;Agency 以下套餐显示前 3 名送礼用户名称,Agency Starter 显示其所在地区榜单上的全部送礼用户名称Agency
主播页面显示数字,身份信息脱敏Basic
送礼用户页面显示数字,身份信息脱敏Agency

为什么要脱敏:数字是公开的,也会一直公开;但完整的名单,尤其是当前正在直播的主播名单,正是有人会从免费页面大批量抓取、用来挖走主播或转售数据的东西。脱敏让榜单依然便于阅读,同时把批量身份数据和付费、可追责的套餐绑定在一起。套餐与价格:价格。

我们保留多长的历史

  • 主播页面 - 近 90 天的排名历史。
  • 主播钻石历史(Agency) - 近 12 个月。
  • 送礼用户页面 - 滚动的 90 天窗口;单个礼物事件保留约 3 个月。
  • 送礼用户榜 - 日榜、周榜和月榜周期。
  • 游戏涨幅榜 - 时间窗口从近 2 小时到近 3 天。
  • 日榜 - 当前榜单日的实时数据,以及各地区页面上近期的每日冠军。
  • 联赛分组 - 当前的周榜周期。

已知空白

  • 标记为不可用的榜单。当 API 对某个榜单返回 available: false 时,说明我们在该地区和时间窗口内没有可用的采集数据。这是覆盖空白,并不代表该地区没有上榜主播。例如,游戏榜并非在每个地区都可用。
  • 仅有小时榜的地区。土耳其和中东和非洲 在 TikTok 上没有日榜,因此其「日榜」视图显示的是当前小时榜。
  • 已归档的日榜页面。并非每个地区和日期都会发布往日日榜的按日归档页面。某个过往日期没有任何数据行,表示我们没有该日期的已发布快照,而不是当天没有人上榜。
  • 空分组。没有上榜主播的联赛分组不会列出;TikTok 重新分配的分组可能在两次采集之间发生变化。
  • 短暂中断。如果 TikTok 一段时间内停止响应,榜单会保留最后一次有效采集,采集时间也会停止更新。依赖某个数字之前,请先检查采集时间。

引用我们的数字之前

  • 榜单上的钻石是 TikTok 在采集时显示的分数,对应当前榜单日(日榜)、榜单周(联赛分组)或榜单小时(小时榜)。
  • 收益和收入数据是根据钻石推算的预估值,并非实际结算金额;主播实际到手多少取决于 TikTok 和公会的条款。
  • 脱敏行是隐藏了名称的真实数据行。请把它们计入总数和排名,不要当作缺失数据。
  • 地区是 TikTok 的排名分区,而不是居住国家。请说「在 北美 地区上榜」,而不是「来自」某个国家。
  • 采集时间:请引用页面或 API 响应中显示的时间,尽量使用 UTC。
  • WebSocket API 文档列出了 90+ 种 LIVE 事件类型,详见API 文档。

报告数据问题

如果某个数字看起来不对,请发送邮件至 [email protected],附上页面 URL 或 API 请求、地区、你看到它的时间(含时区)以及你预期看到的内容。附上同一时间 TikTok App 中同一榜单的截图,是我们确认并修复问题最快的方式。隐私相关请求请参阅隐私政策。