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.
wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEYConnect 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);
});Every event, real-time
Structured JSON events for every interaction in the stream. All delivered in milliseconds.
Chat Messages
Every chat message with user data, emotes, badges, auto-detected language, and reply target.
Emote Chat
Sticker / emoji-only comments separated from text chat.
Comment Deletions
Moderator-removed comments delivered as their own event for clean UI sync.
Pinned Comments
Host-pinned chats and subscriber-pinned messages.
Floating Banners
Barrage and bottom-screen system banners (Super Fan, fan club, gift hints).
System Toasts
Generic system toast popups pushed inside the room.
Likes
Like batches with user info and running totals.
Shares
Track when viewers share the livestream.
Follows
New follower events during the stream.
Subscriptions
Paid subscription events and renewal notifications.
Red Envelopes
Virtual red-envelope drops and portal bursts.
Super Fan
Super Fan tier achievements, joins, and milestone boxes.
Fan Club
Fan club events including PK fan ticket activity.
Virtual Gifts
Gift name, diamond value, repeat count, streaks, transaction IDs, sender relationship.
Gift Catalog Updates
Refreshed gift panels and curated gift collections.
Gift Goals
Gift goal progress and milestone unlocks.
Gift Restrictions
Dynamic gift restriction changes inside the room.
Featured Gifts
Featured gift gallery + revenue-share notices.
Member Joins
See who enters with entry source (homepage_hot, follow-tab, recommendation, etc.).
Viewer Count
Live viewer count updates in real-time.
Viewer Leaderboard
Ranked viewer / gifter leaderboards with score deltas.
Hourly Ranking
Hourly rank position changes for the host.
Rank Text Overlays
Ranking text strings shown over the stream.
PK Battles
Battle start, score updates, and result events.
Battle Armies
Per-side army / contributor breakdown for the active PK.
Power-Up Cards
Battle item card events (boosts, mist, vault gloves).
Battle Notices
Match notices, gameplay state, and punish-phase end.
Opponent Gifts
Real-time gifts on the opposing host's side during PK.
Live Captions
AI speech-to-text with auto language detection and translation. Exclusive.
Link Mic
Cohost / Multi-guest link mic state and slot layout changes.
Cohost Layout
Cohost layout and settings updates.
Polls
Live polls with options and result deltas.
Live Karaoke
Karaoke queue requests and track activity.
Pictionary
Drawing game start, updates, end, and exit events.
Mini-Game Moments
In-room mini-game state, server features, auto-posts.
Q&A
Viewer questions, host selection, dismiss UX.
Cross-Stream Competitions
Competition events with per-contributor breakdown.
Guest Showdown
Guest showdown rounds and contributor info.
Live Shopping
Live commerce events including manager, billboard, short item refresh.
Stream Lifecycle
Connection ready, room info, control messages, stream status.
Access Control
Access recall, blocked viewer, room verification.
In-Room Banners
In-room banner notifications and host announcement boards.
Stream Intro
Stream intro overlay events.
Privilege Upgrades
Viewer privilege advance notifications.
Host Tool Changes
Anchor tool modification and host-side configuration changes.
Hot Room
Room hot / cold state signal.
Group LIVE
Group live member notifications.
Viewer Picks
Viewer picks updates inside the room.
Room Stickers
Host-placed sticker overlays.
AI Stream Summary
AI-generated stream summary highlights.
SMB Boards
Small-business board overlays.
Capsules & Push Guides
Capsule overlays, push guides, perception hints.
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 | ✅ 2,500 req/day | ✅ | ✅ MIT-licensed |
| Uptime SLA | 99.9% | 99.9% | N/A |
🎤 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.
Transparent Pricing
Start free, scale when you're ready.
Works with every language
Official SDKs for Node.js and Python. WebSocket works with everything else.
Start streaming TikTok LIVE data today
Sandbox tier - 2,500 requests/day, 15 WebSocket connections. No credit card required.