WebSocket API

TikTok LIVE
WebSocket API

透過一條託管 WebSocket 連線，串流即時 TikTok LIVE 事件：聊天、禮物、按讚、追蹤、觀眾人數、PK。延遲低於 50ms，可用率 99.9%。

取得免費 API 金鑰查看文件

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

<50ms延遲

99.9%可用率

90+事件類型

任何語言

3 行程式碼就能連線

不用解析二進位資料，沒有基礎架構負擔。只要一個 WebSocket 網址，就能收到乾淨的 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收到禮物的直播主。在多人共同直播中，這是特定的來賓 / 直播主，不一定是直播間擁有者。