Unofficial third-party API that delivers real-time chat messages, virtual gifts, viewer counts, battle scores, and 18+ event types from any TikTok broadcast via WebSocket. SDKs for Node.js and Python. Not affiliated with TikTok or ByteDance.
Works in Node.js 18+, Bun, and Deno. TypeScript types included. Zero dependencies beyond
ws.
Python 3.8+. Async-first with websockets. Or use the raw WebSocket URL from any
language.
chat
Messages, emotes, user info
gift
Gifts, diamond values, streaks
like
Likes with running total
follow
New followers during stream
member
Viewer join events
share
Stream share events
roomUserSeq
Live viewer count
battle
Battle scores, teams
caption
AI speech-to-text
subscribe
Subscriber alerts
roomPin
Pinned messages
envelope
Treasure chest events
| TikTok Live API (TikTool) | TikTokLive (Python) | tiktok-live-connector | Euler Stream | |
|---|---|---|---|---|
| Stability | 99.9% uptime SLA | Breaks on updates | Unmaintained | Managed |
| Node.js SDK | ✓ tiktok-live-api | Python only | ✓ Outdated | No SDK |
| Python SDK | ✓ tiktok-live-api | ✓ | Node only | No SDK |
| Any language | ✓ Raw WebSocket | Python only | Node only | ✓ |
| AI Captions | ✓ Built-in | No | No | No |
| CAPTCHA handling | ✓ Auto-solved | Manual | None | ✓ |
| Free tier | ✓ No credit card | Free but breaks | Broken | Paid only |
No. TikTok does not provide any public API for live stream events. TikTool reverse-engineers the internal WebCast protocol and delivers events through a clean WebSocket interface. Protocol maintenance, CAPTCHA challenges, room authentication, and signature rotation are all handled server-side so your integration never breaks.
Yes. The free Sandbox tier includes 1 WebSocket connection and 50 REST API calls per day, forever. No credit card required. You can also test instantly with the public demo key on this page. Paid plans start at $7/week for production use.
Official SDKs for Node.js (npm install tiktok-live-api) and
Python (pip install tiktok-live-api). The raw WebSocket endpoint
works with any language that supports WebSocket: Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin,
Swift.
Libraries like TikTokLive and tiktok-live-connector connect directly to TikTok's internal protobuf protocol and break every time TikTok pushes an update. TikTool is a managed API: protocol changes, CAPTCHAs, and authentication are all handled server-side. Compared to EulerStream, TikTool is 2.5 to 7x cheaper at every paid tier with signatures, CAPTCHA solving, and priority routing included at no extra cost.
18+ real-time event types: chat messages, virtual gifts with diamond values, likes, follows, shares, viewer counts, battle scores, subscriber alerts, pinned messages, stream status changes, and AI-powered live captions with speaker identification and translation into 50+ languages.
Under 50 milliseconds. Events arrive within 50ms of occurring on TikTok, making it suitable for real-time applications: live overlays, interactive games, chat bots, and analytics dashboards.
Yes. The real-time WebSocket API delivers chat messages with full user metadata instantly. Build chat bots, auto-moderators, command systems, OBS overlays, gift leaderboards, and interactive viewer experiences. See the chat bot guide for a walkthrough.
Depends on your plan: Sandbox (1 stream), Basic (3 streams), Pro (50 streams), Ultra (500 streams). Each WebSocket connection monitors one live stream in real-time.
Free tier. No credit card. Start receiving live events immediately.