TikTok Live API Documentation

Connect to any TikTok LIVE stream and receive real-time chat, gifts, likes, viewer counts, and battle data. Code examples in 6 languages. Free sandbox — no credit card needed.

Base URL: wss://api.tik.tools (WebSocket) · https://api.tik.tools (REST)

Welcome to TikTool

TikTool is the developer-first TikTok LIVE API. Connect to any live stream and receive real-time events — chat messages, virtual gifts, likes, follows, viewer counts, battles, and more — with sub-50ms latency and 99.9% uptime.

Quick Start

Get connected to a live stream in under 30 seconds with code in 6 languages.

WebSocket API

Real-time events via WebSocket. 30+ event types. Sub-50ms latency.

REST API

16 REST endpoints for signing, live checks, room data, rankings, and more.

Live Captions

Real-time AI transcription and translation for any TikTok Live stream.

Connect in 5 Lines

Node.js

import WebSocket from 'ws';

const ws = new WebSocket('wss://api.tik.tools?uniqueId=streamer&apiKey=YOUR_KEY');
ws.on('message', (raw) => {
  const { event, data } = JSON.parse(raw);
  if (event === 'chat') console.log(`${data.user.uniqueId}: ${data.comment}`);
  if (event === 'gift') console.log(`🎁 ${data.user.uniqueId} sent ${data.giftName} (${data.diamondCount}💎)`);
});

Why TikTool?

30+ Real-Time Events

Chat, gifts, likes, follows, battles, viewer counts, room pins, shares — all decoded from TikTok’s protobuf protocol.

6 Languages

Node.js, Python, Go, Java, C#, Rust — code examples for every endpoint and event.

Free Sandbox

50 requests/day, 1 WebSocket connection. No credit card. Upgrade when you need more.

Sub-50ms Latency

Events arrive in under 50 milliseconds. 99.9% uptime SLA on edge infrastructure.

AI Live Captions

The only TikTok Live caption API — auto language detection, translation to 50+ languages, speaker diarization.

Open Source SDK

MIT-licensed Node.js and Python SDKs. Full source on GitHub.

Pricing

Tier	Price	Daily Requests	WebSocket Connections	Duration
Sandbox	Free	50/day	1	5 min
Basic	$7/wk	10,000/day	5	30 min
Pro	$15/wk	75,000/day	50	Unlimited
Ultra	$45/wk	300,000/day	500	Unlimited

Get your free API key

Sign up at tik.tools and start building in 30 seconds.

Explore

WebSocket Events Reference

All 30+ event types with JSON schemas and field descriptions.

REST API Endpoints

16 endpoints: signing, live checks, room data, rankings, gifts, and more.

Node.js SDK

npm install @tiktool/live — event-driven API with auto-reconnect.

Python SDK

pip install tiktok-live-api — decorator-based event handling.

Unreal Engine Plugin

Build viewer-controlled games with TikTok Live events in UE5.

Authentication

API keys for backend, JWT tokens for frontend. Never expose your key.