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. Sandbox is a free 7-day evaluation - 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.

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.

7-Day Sandbox

Free 7-day evaluation: 5,000 requests/day, 3 WebSocket connections. No credit card. Move to a paid plan to keep building.

Sub-50ms Latency

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

Open Source SDK

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

Pricing

Tier	Daily Requests	WebSocket Connections	Duration
Sandbox (7-day evaluation)	5,000/day	3	2 hours
Basic	10,000/day	20	8 hours
Pro	75,000/day	50	12 hours
Ultra	300,000/day	250	24 hours
Agency	1,000,000/day	500	24 hours

Sandbox is a free 7-day evaluation counted from the day your account was created. After that the key is refused until the account moves to a paid plan (Basic, Pro, Ultra, or Agency). See tik.tools/pricing for current plans and prices.

Get an API key (7-day free evaluation)

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.