Developer Guides

TikTok LIVE API Developer Guides

Step-by-step tutorials to help you build with TikTok LIVE data. From your first connection to production-ready applications.

Quick Start

Getting Started with TikTok LIVE API

Install the SDK, get a 7-day evaluation key, connect to any live stream, and receive real-time events in minutes.

2 min readBeginner
→
Guide

TikTok LIVE WebSocket API

Connect to any TikTok LIVE stream via WebSocket. Receive real-time chat, gifts, viewer counts and battles.

5 min readBeginner
→
Guide

TikTok LIVE Webhooks

Get a signed HTTPS POST when a creator goes live or ends a stream. live.start and live.end with retries, replay and signature checks.

4 min readBeginner
→
Tutorial

Build a TikTok Live Chat Assistant in 5 Minutes

Create a fully functional chat assistant that responds to commands, tracks gifts, maintains a leaderboard, and welcomes viewers.

5 min readBeginner
→
Tutorial

Build a TikTok LIVE Stream Overlay

Create an OBS-compatible browser source overlay with real-time chat feed, animated gift alerts, and viewer count display.

10 min readIntermediate
→
Tutorial

TikTok LIVE API Python Guide

Connect to any TikTok LIVE stream from Python using WebSocket. Real-time chat, gifts, viewer counts - a production-ready alternative to TikTokLive library.

5 min readBeginner
→
Reference

TikTok LIVE API Events Reference

Complete reference for all real-time WebSocket events: chat, gift, like, follow, viewer count, battles, subscriptions, and more.

8 min readAll Levels
→
Guide

Text to Speech TTS on TikTok Live

Learn how to use text-to-speech on TikTok Live streams. Build TTS assistants, read chat aloud, and create interactive voice experiences.

5 min readBeginner
→
Migration

Migrate from TikTok-Live-Connector

Move from tiktok-live-connector to the managed API: change the import and the constructor, keep your event handlers.

2 min readAll Levels
→
Migration

Switch from TikTok-Live-Connector or TikTokLive

Side-by-side Node and Python code, theirs and ours, with an event name map. Every snippet was run against a live stream.

6 min readIntermediate
→
Troubleshooting

Fix common TikTok LIVE connector errors

SignatureRateLimitError, Failed to sign request, user_not_found, the September 2026 sign outage and the VPN-only problem: what each error means and how to fix it.

4 min readAll Levels
→
Automation

Automation recipes for n8n and Claude

Ready n8n workflows for go-live alerts, a daily recruit list and a weekly roster report, plus a prompt pack for the TikTok LIVE MCP server.

5 min readBeginner
→