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.
wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEYReal-timeEvent delivery
90+Event Types
AnyLanguage
Connect in a few 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.How TikTools compares
Side-by-side comparisons with other TikTok LIVE data providers, each dated and checked against their public pages.
See comparisonsTransparent Pricing
Evaluate free for 7 days, then pick the plan you need.
Pro
From $15/wk
- Production request and WebSocket limits
- Signed webhooks
- Up to 50 concurrent live streams
Works with every language
Official SDKs for Node.js and Python. WebSocket works with everything else.
Start streaming TikTok LIVE data today
Sandbox tier - 5,000 requests/day, 3 concurrent WebSocket connections. No credit card required.