Was ist die TikTok LIVE API?
TikTok bietet keine öffentliche API für Livestream-Daten wie Chat, Geschenke oder Zuschauerzahlen. Die TikTok Business API deckt nur Werbung und Shop-Analytics ab. Für LIVE-Daten in Echtzeit nutzen Entwickler APIs von Drittanbietern.
Die Open-Source-Bibliotheken tiktok-live-connector (Node.js) und TikTokLive (Python) stehen unter MIT-Lizenz und sind kostenlos nutzbar. Das TikTok-Signing geben sie an ein Backend ab; eine der bisherigen Standardoptionen ist ein kostenpflichtiger Signing-Dienst vom selben Team, das diese Bibliotheken pflegt.
TikTool ist eine unabhängige Alternative mit eigener Signing-Infrastruktur. Eine komplett gemanagte API: Verbindungspflege und Authentifizierung laufen bei uns. Eine WebSocket-Verbindung liefert 90+ Eventtypen - Chat, Geschenke, Likes, Follows, Zuschauer, Battles und mehr. Offizielle SDKs für Node.js und Python. Sandbox-Tarif, keine Kreditkarte nötig.
Wie funktioniert die TikTok LIVE API?
TikTool sitzt zwischen deiner Anwendung und TikToks Livestream-Infrastruktur. So sieht die Architektur aus:
Deine App verbindet sich
Deine App öffnet eine WebSocket-Verbindung zu wss://api.tik.tools mit einem TikTok-Usernamen und deinem API-Key.
TikTool übernimmt
TikTool ermittelt die Room-ID, übernimmt die Authentifizierung, löst Challenges und tritt dem Livestream bei.
Events fließen
Echtzeit-Events (Chat, Geschenke, Zuschauer usw.) kommen als sauberes JSON in deiner App an - geparst, strukturiert und typisiert.
Mit TikToks Protokoll hast du nie direkt zu tun. Wenn TikTok seine internen Systeme ändert (was oft passiert), passt sich TikTool an - dein Code läuft unverändert weiter.
Schnellstart - Node.js / TypeScript
Installiere das offizielle SDK von npm:
npm install @tiktool/liveVerbinde dich mit einem Livestream und empfange Events:
import { TikTokLive } from '@tiktool/live';
const client = new TikTokLive({
uniqueId: 'streamer_username',
apiKey: 'YOUR_API_KEY' // Get free key → https://tik.tools
});
client.on('chat', (event) => {
console.log(`${event.user.uniqueId}: ${event.comment}`);
});
client.on('gift', (event) => {
console.log(`${event.user.uniqueId} sent ${event.giftName} (${event.diamondCount} diamonds)`);
});
client.on('roomUserSeq', (event) => {
console.log(`${event.viewerCount} viewers watching`);
});
client.connect();Volle TypeScript-Unterstützung - jeder Eventtyp, jedes Feld und jeder Parameter ist komplett typisiert, mit Autovervollständigung in deiner IDE. Zum kompletten Node.js-Guide →
Schnellstart - Python
Installation über PyPI:
pip install tiktok-live-apiVerbinde dich mit dem SDK und registriere Handler per Decorator:
from tiktok_live_api import TikTokLive
client = TikTokLive("streamer_username", api_key="YOUR_API_KEY") # Get free key at https://tik.tools
@client.on("chat")
def on_chat(event):
print(f"{event['user']['uniqueId']}: {event['comment']}")
@client.on("gift")
def on_gift(event):
print(f"{event['user']['uniqueId']} sent {event['giftName']} ({event['diamondCount']} diamonds)")
@client.on("roomUserSeq")
def on_viewers(event):
print(f"{event['viewerCount']} viewers watching")
client.run() # blocks; reconnects automaticallyLieber asyncio? await client.connect() lässt denselben Client in deinem eigenen Event-Loop laufen. Der Key kann auch aus der Umgebungsvariable TIKTOOL_API_KEY kommen.
Schnellstart - Raw WebSocket (jede Sprache)
Jede Sprache mit WebSocket-Unterstützung funktioniert - Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Verbinde dich einfach mit:
wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEYJede Nachricht ist ein JSON-Objekt mit den Feldern event und data. Saubere, strukturierte Daten - kein binäres Parsen nötig. Komplette WebSocket-API-Referenz →
Alle Eventtypen
Die TikTok LIVE API streamt 18+ Echtzeit-Events aus jedem Livestream:
chatChatnachricht eines Zuschauers. Mit User-Infos, Kommentartext, Emotes und Badges.
giftVirtuelles Geschenk eines Zuschauers. Mit Geschenkname, Diamantwert, Wiederholungszahl und Combo-Status.
likeEin Zuschauer hat den Stream geliked. Mit Anzahl pro Event und Gesamt-Likes.
memberEin Zuschauer ist dem LIVE-Raum beigetreten. Wird ausgelöst, wenn User den Stream betreten.
followEin Zuschauer ist dem Streamer während des Livestreams gefolgt.
shareEin Zuschauer hat den Livestream mit Freunden geteilt.
subscribeEin Zuschauer hat den Streamer abonniert.
roomUserSeqUpdate der Zuschauerzahl. Aktuelle Zuschauerzahl und Liste der Top-Zuschauer.
battleBattle/LinkMic-Event. Battle-Status, Teams, Punktestände und Teilnehmer.
battleArmiesUpdate der Battle-Armeen mit Teampunkten und Teilnehmer-Ranking.
roomPinDer Streamer hat eine Chatnachricht angepinnt oder markiert.
captionTikToks native Auto-Untertitel für den Stream, ein Untertitelfenster pro Frame.
envelopeSchatztruhen- oder Umschlag-Event im Stream.
emoteEigenes Emote, das ein Zuschauer im Chat gesendet hat.
liveIntroUpdate des Stream-Intros - Änderungen an Titel und Beschreibung.
streamEndDer Livestream ist beendet. Mit Grund-Code.
connectedErfolgreich mit dem TikTok-Livestream verbunden.
errorEin Verbindungsfehler ist aufgetreten. Mit Fehlerdetails.
Komplette Event-Referenz mit Beispiel-Payloads ansehen →
Was kannst du bauen?
Chat-Assistenten
Bau automatische Chat-Assistenten, die in Echtzeit auf Nachrichten, Befehle und Geschenke der Zuschauer reagieren.
Analytics
Verfolge Zuschauerzahlen, Engagement-Raten, Geschenk-Umsatz und Chat-Aktivität über alle Streams hinweg.
Interaktive Spiele
Lass Zuschauer Spielelemente mit Geschenken, Chat-Befehlen und Likes steuern.
Stream-Overlays
Erstelle Overlays für OBS/Streamlabs mit Chat, Geschenk-Alerts und Zuschauer-Stats.
Creator-Scouting
Verfolge Creator-Rankings, Top-Gifter und Liga-Tabellen, um Talente zu finden und aufzubauen.
Mobile Apps
Bau Mobile Apps, die TikTok-LIVE-Streams überwachen und mit ihnen interagieren.
TikTool vs. Euler Stream vs. tiktok-live-connector
Die Open-Source-Bibliotheken tiktok-live-connector (Node.js) und TikTokLive (Python) werden vom selben Team gepflegt, das Euler Stream betreibt. Zusammen bilden sie ein gut unterstütztes Ökosystem aus MIT-lizenzierten Clients und einem gemanagten Signing-Backend. TikTool ist eine unabhängige Managed-Alternative mit eigener Signing-Infrastruktur und einem anderen Feature-Fokus.
eulerstreamPreise und kostenloser Tarif
Leg kostenlos mit der TikTok LIVE API los. Keine Kreditkarte nötig.