WebSocket API

TikTok LIVE
WebSocket API

Stream real-time TikTok LIVE events - chat, gifts, likes, follows, viewer counts, battles - through a single managed WebSocket connection. Sub-50ms latency. 99.9% uptime.

Get Free API Key View Documentation

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

<50msLatency

99.9%Uptime

18+Event Types

AnyLanguage

Connect in 3 lines of code

No binary parsing, no infrastructure overhead. Just a WebSocket URL delivering clean 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);
});

Explore every event

Pick an event to see the exact JSON your WebSocket delivers, with each field explained.

Virtual Gifts

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
  }
}

giftNamestringDisplay name of the gift sent.

diamondCountnumberDiamond value of a single gift unit.

repeatCountnumberHow many were sent in the combo.

repeatEndbooleantrue when a streak has finished - sum on this frame.

userobjectSender profile: uniqueId, nickname, follow + subscriber status.

receiverUserIdstringThe creator the gift was sent to. In a multi-guest LIVE this is the specific guest/host, not always the room owner.

Why developers choose TikTool

The most complete TikTok LIVE WebSocket API available.

	TikTool Live	Euler Stream	TikTok-Live-Connector
WebSocket API	✅	✅	Self-hosted client
Managed Infrastructure	✅	✅	Self-hosted
AI Live Captions (STT)	✅	❌	❌
CAPTCHA Solving	✅ Pro+	✅	Via signing backend
Feed Discovery	✅	❌	❌
Node.js SDK	✅ @tiktool/live	✅ eulerstream	✅
Python SDK	✅ tiktok-live-api	✅ via TikTokLive	❌
Free Tier	✅ 5,000 req/day	✅	✅ MIT-licensed
Uptime	99.9%	99.9%	N/A

Exclusive Feature

🎤 AI-Powered Live Captions

Real-time speech-to-text transcription with automatic language detection, translation to 50+ languages, and speaker diarization. No other TikTok API offers this.

Learn More Documentation