WebSocket API

TikTok LIVE
WebSocket API

通过一个托管 WebSocket 连接，实时接收 TikTok LIVE 事件：弹幕、礼物、点赞、关注、观众人数、PK。延迟低于 50ms，99.9% 可用性。

免费获取 API Key 查看文档

wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY

<50ms延迟

99.9%可用性

90+事件类型

任意语言

3 行代码即可连接

无需解析二进制，无需维护基础设施。一个 WebSocket URL 直接推送干净的 JSON。

import WebSocket from 'ws';

const ws = new WebSocket('wss://api.tik.tools?uniqueId=streamer&apiKey=YOUR_KEY');

ws.on('message', (raw) => {
  const msg = JSON.parse(raw);
  console.log(msg.event, msg.data);
});

浏览所有事件

选择一个事件，查看 WebSocket 推送的完整 JSON 及每个字段的说明。

虚拟礼物

event: "gift"

{
  "event": "gift",
  "data": {
    "user": {
      "uniqueId": "streamfan_22",
      "nickname": "Stream Fan",
      "userId": "6776543210987654321",
      "followRole": 2,
      "isSubscriber": true
    },
    "giftId": 5655,
    "giftName": "Rose",
    "diamondCount": 1,
    "repeatCount": 12,
    "repeatEnd": true,
    "groupId": "1718900000123",
    "giftType": 1,
    "receiverUserId": "6776000000000000010",
    "timestamp": 1718900000123
  }
}

giftNamestring所送礼物的显示名称。

diamondCountnumber单个礼物的钻石价值。

repeatCountnumber本次连送的数量。

repeatEndboolean连击结束时为 true，请在这一帧进行累加。

userobject送礼者资料：uniqueId、昵称、关注及订阅状态。

receiverUserIdstring礼物接收的主播。在多人连麦 LIVE 中，这是具体的嘉宾 / 主播，不一定是房主。