Unofficial third-party API to connect to any live broadcast and receive every chat message, gift, like, follow, viewer count, and battle event as JSON over WebSocket. SDKs for Node.js and Python. Works from any language. Not affiliated with TikTok or ByteDance.
Zero config. Auto-finds a live stream.
Or connect to a specific stream:
npx tiktok-live-api @username
Or connect to a specific stream:
python -m tiktok_live_api @username
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 is handled server-side - challenge solving, room authentication, and signature rotation are automatic. Your integration never breaks when the platform pushes updates.
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 - no signup needed. 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, and more.
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 are delivered within 50ms of occurring on TikTok. Designed for real-time applications: live overlays, interactive games, chat bots, analytics dashboards.
Yes. TikTool's real-time WebSocket API delivers chat messages with full user metadata instantly. You can build chat bots, auto-moderators, command systems, and interactive viewer experiences. See the chat bot guide for a complete walkthrough.
Yes. The API provides real-time gift animations, chat messages, viewer counts, and battle scores - perfect for OBS, Streamlabs, or TikTok Live Studio overlays. See the overlay guide for implementation details.
Yes. Full battle support including battle start/end events, real-time scores for both sides, army size, and battle results. Perfect for building battle leaderboards, competitive analytics, and live commentary systems.
Depends on your plan: Sandbox (1 stream), Basic (3 streams), Pro (50 streams), Ultra (500 streams). Enterprise plans support custom limits. Each WebSocket connection monitors one live stream in real-time.
Free tier. No credit card. Start receiving live events immediately.