How it works

Everything live, in one integration

Connect once and pull real-time events, creator ranks, and AI captions from a single endpoint.

  1. 1REAL-TIME WEBSOCKET

    Connect the WebSocket

    One persistent socket streams chat, gifts, likes, follows, and viewer counts with sub-50ms latency in any language.

    WebSocket API
  2. 2LEADERBOARDS & RANKS

    Track gifts, chat & ranks

    Layer in diamond leaderboards, regional creator rankings, and gaming or shopping boards across 28 regions.

    Explore ranks
  3. 3AI CAPTIONS

    Ship your app

    Add AI live captions, overlays, and translation across 60+ languages, then ship with the MIT-licensed SDK.

    See captions
Who builds on it

Built for the TikTok LIVE ecosystem

One platform serving everyone who works around live streams - from solo developers to multi-creator agencies.

The platform

One API. Every TikTok LIVE signal.

Real-time events, creator rankings, gaming and shopping boards, AI captions, and gifter intelligence - all from a single endpoint.

Platform

Everything to build on TikTok LIVE

From prototyping to production scale. Start free, no credit card required.

WEBSOCKET

Real-Time WebSocket

Sub-50ms event delivery. Chat, gifts, follows, shares, likes, viewer count - all streamed through a single persistent connection.

CHAT

Chat & Comments

Every message with full user profiles, badges, emotes, and link metadata. Filter, moderate, or pipe into your AI models.

GIFTS

Gifts & Diamonds

Track virtual gifts in real-time with diamond values, streak combos, and repeat counts. Build donation alerts and leaderboards.

KEYS

API Key Management

Generate scoped API keys with tier-based rate limits. Free tier for development, paid tiers for production traffic.

ANALYTICS

Analytics Ready

Structured event data ready for dashboards, databases, or data pipelines. Every event comes with timestamps and metadata.

OPEN SDK

Open Source SDK

MIT licensed. TypeScript-first with full type definitions. Works with Node.js, Bun, and Deno. Build assistants, overlays, or anything.

Quick Start

One install. Real-time data.

See live TikTok stream data flowing in your terminal in under 30 seconds.

$npm install @tiktool/live
Tik.Tools Live - Visual Studio Code
TerminalProblemsOutput
$ npx tsx index.ts
[i] connecting to wss://api.tik.tools
--------------------------------
_
Copy-paste examples

Three working files. Pick a language. Run it.

No signup, no credit card, no npm install for HTML / Node 22. The demo key your_api_key is baked in - real free key + higher limits at tik.tools/login.

Live events monitor

Stream real-time chat, gifts, likes, follows + viewer counts from any TikTok LIVE creator via WebSocket.

Node.jsPythonHTML / JSLLM prompt
Works without signup
live-events-monitor.html
<!DOCTYPE html>
<!-- Save as live-events.html and double-click. No build step. No signup. -->
<meta charset="utf-8">
<title>Tik.Tools live events</title>
<style>
  body{font:14px ui-monospace,Menlo,monospace;background:#0a0a0c;color:#e4e4e7;padding:24px;max-width:760px;margin:0 auto}
  h1{font-size:18px;margin:0 0 8px}
  .bar{display:flex;gap:8px;margin:8px 0 14px}
  input,button{font:inherit;background:#14141a;color:#fff;border:1px solid #333;border-radius:6px;padding:6px 10px}
  button{background:#2a2a2a;border:n ...

Live video player

Play any TikTok LIVE stream in a standard <video> tag. Stream URLs come baked in to the public ticker - no extra auth call.

Node.jsPythonHTML / JSLLM prompt
Works without signup
live-video-player.html
<!DOCTYPE html>
<!-- Save as live-video.html and double-click. Public endpoint, no signup. -->
<meta charset="utf-8">
<title>Tik.Tools live video</title>
<style>
  body{margin:0;background:#000;color:#fff;font:14px system-ui}
  video{width:100%;max-width:900px;display:block;margin:0 auto;background:#000}
  .bar{display:flex;gap:8px;justify-content:center;padding:10px}
  input,button{font:inherit;background:#14141a;color:#fff;border:1px solid #333;border-radius:6px;padding:6px 10px}
  button{background:#2a2a2a;borde ...

Live top channels (public, no auth)

List 10 currently-live TikTok creators across the world. Free, rate-limited 1 call per 5 min per IP.

Node.jsPythonHTML / JSLLM prompt
Works without signup
live-top-channels-public-no-auth.html
<!DOCTYPE html>
<meta charset="utf-8">
<title>Tik.Tools top live channels</title>
<style>
  *{box-sizing:border-box}
  body{font:14px -apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0a0a0e;color:#e4e4e7;margin:0;padding:14px}
  .head{display:flex;justify-content:space-between;align-items:center;margin:0 0 10px;padding:0 4px}
  .head b{color:#fff;font-size:13px;font-weight:700;letter-spacing:.01em}
  .head .dot{display:inline-block;width:6px;height:6px;border-radius:50%;background:#22c55e;m ...
Demo limits 1 WebSocket / 10-min sessions / 6 connects per hour per IP. Need more? Get a free API key.
Use Cases

What Can Developers Build with TikTok LIVE Data?

Chat assistants, stream overlays, analytics dashboards, AI integrations, game triggers - all from a single WebSocket with sub-50ms latency.

CHAT

Chat Assistants

Auto-respond, moderate, and run interactive chat games.

OVERLAYS

Stream Overlays

Real-time chat, gift alerts, and viewer counts for OBS.

GIFTS

Gift Tracking

Diamond leaderboards, donation goals, and alert systems.

ANALYTICS

Analytics

Engagement metrics, viewer trends, and revenue tracking.

AI

AI Integrations

Sentiment analysis, auto-moderation, and smart responses.

GAMES

Game Integrations

Unreal Engine plugin for viewer-controlled games.

FAQ

Frequently Asked Questions About the TikTok LIVE API

Everything developers ask before building on the TikTok LIVE WebSocket - protocol, signing, pricing, language support.

Is there an official TikTok LIVE API?

Are TikTok LIVE libraries like tiktok-live-connector free?

What is the difference between Tik.Tools and Euler Stream?

How do I connect to a TikTok LIVE stream?

What data can I get from TikTok LIVE streams?

What programming languages work with TikTok LIVE API?