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 | |
|---|---|---|---|---|
| Hosting model | Fully managed, 99.9% uptime | Self-hosted client | Self-hosted client | Managed signing backend |
| Node.js SDK | ✓ tiktok-live-api | Python only | ✓ tiktok-live-connector | ✓ eulerstream |
| Python SDK | ✓ tiktok-live-api | ✓ | Node only | ✓ via TikTokLive |
| Any language | ✓ Raw WebSocket | Python only | Node only | ✓ |
| AI Captions (STT + translation) | ✓ Built-in | No | No | No |
| Unreal Engine plugin | ✓ | No | No | No |
| Gifter Intel (LTV, archetypes) | ✓ | No | No | No |
| Historical Leaderboards | ✓ Regional + global | No | No | No |
| Battle History + Timeline | ✓ Per-match | No | No | No |
| League Rankings | ✓ Diamond Rush | No | No | No |
| Real-time Alerts | ✓ Discord + Telegram | No | No | No |
| Sniper Gap (live tracker) | ✓ | No | No | No |
| Agency CRM + Watchlists | ✓ | No | No | No |
| Public Profile Pages | ✓ Indexed | No | No | No |
| CAPTCHA handling | ✓ Auto-solved | Via signing backend | Via signing backend | ✓ |
| Free tier | 2,500 req/day | ✓ MIT-licensed | ✓ MIT-licensed | 1,000 req/day |
There is no first-party public API for live stream events. TikTool is an independent, third-party managed API that delivers live stream events through a clean WebSocket interface. All maintenance, challenge solving, room authentication, and signature rotation are 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.
Open-source clients like tiktok-live-connector (Node.js) and TikTokLive (Python) are MIT-licensed and delegate signing to a managed backend (default: Euler Stream). TikTool is an independent managed API with its own signing infrastructure: all maintenance, CAPTCHA solving, and authentication are handled server-side. At the base paid tier, TikTool's Pro plan publishes 75,000 daily REST requests at $15/week - compare directly against each provider's currently published quotas to evaluate cost per request for your workload.
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.