TikTok LIVE API

Il n'existe pas d'API TikTok LIVE officielle. TikTool est une alternative managée - connecte-toi à n'importe quel live et reçois le chat, les cadeaux et les spectateurs en temps réel via WebSocket. Maintien de la connexion et authentification gérés pour toi. Pas besoin de rétro-ingénierie.

Obtenir une clé APIObtiens une clé API
Docspour les développeurs
Chargement du carrousel de démo 3D...

Classements gaming

NOUVEAU · EXCLUSIVITÉ AGENCES
Top 5 actuel - Gaming États-UnisClassement complet
<50msLatence
99.9%Disponibilité
GratuitOffre Sandbox

C'est quoi, l'API TikTok LIVE ?

TikTok ne propose pas d'API publique pour les données de live comme le chat, les cadeaux ou le nombre de spectateurs. L'API TikTok Business ne couvre que la pub et les statistiques de la boutique. Pour accéder aux données LIVE en temps réel, les développeurs passent par des API tierces.

Les bibliothèques open source tiktok-live-connector (Node.js) et TikTokLive (Python) sont sous licence MIT et gratuites. Elles délèguent la signature TikTok à un backend ; l'une des options historiques par défaut est un service de signature payant créé par l'équipe qui maintient ces bibliothèques.

TikTool est une alternative indépendante avec sa propre infrastructure de signature. C'est une API entièrement managée : le maintien de la connexion et l'authentification sont gérés de notre côté. Une seule connexion WebSocket fournit 90+ types d'événements - chat, cadeaux, likes, follows, spectateurs, battles et plus encore. SDK officiels pour Node.js et Python. Offre Sandbox, sans carte bancaire.

Comment fonctionne l'API TikTok LIVE ?

TikTool se place entre ton application et l'infrastructure de live de TikTok. Voici l'architecture :

1

Ton app se connecte

Ton app ouvre un WebSocket vers wss://api.tik.tools avec un pseudo TikTok et ta clé API.

2

TikTool fait le lien

TikTool trouve l'ID de la room, gère l'authentification, résout les vérifications et rejoint le live.

3

Les événements arrivent

Les événements en temps réel (chat, cadeaux, spectateurs, etc.) arrivent dans ton app en JSON propre - parsé, structuré et typé.

Tu ne touches jamais directement au protocole de TikTok. Quand TikTok modifie ses systèmes internes (ce qui arrive souvent), TikTool s'adapte - ton code continue de fonctionner sans changement.

Démarrage rapide - Node.js / TypeScript

Installe le SDK officiel depuis npm :

npm install @tiktool/live

Connecte-toi à un live et reçois les événements :

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();

Support TypeScript complet - chaque type d'événement, champ et paramètre est entièrement typé, avec l'autocomplétion dans ton IDE. Lire le guide Node.js complet →

Démarrage rapide - Python

Installe depuis PyPI :

pip install tiktok-live-api

Connecte-toi avec le SDK et enregistre tes handlers avec des décorateurs :

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 automatically

Tu préfères asyncio ? await client.connect() fait tourner le même client dans ta propre boucle d'événements. La clé peut aussi venir de la variable d'environnement TIKTOOL_API_KEY.

Lire le guide Python complet →

Démarrage rapide - WebSocket brut (tous langages)

Tout langage qui gère WebSocket fonctionne - Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Il suffit de se connecter à :

wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEY

Chaque message est un objet JSON avec les champs event et data. Des données propres et structurées - aucun parsing binaire nécessaire. Référence complète de l'API WebSocket →

Tous les types d'événements

L'API TikTok LIVE diffuse 18+ événements en temps réel depuis n'importe quel live :

chat

Message de chat d'un spectateur. Inclut les infos utilisateur, le texte du commentaire, les emotes et les badges.

gift

Cadeau virtuel envoyé par un spectateur. Inclut le nom du cadeau, sa valeur en diamants, le nombre de répétitions et l'état du combo.

like

Un spectateur a liké le live. Inclut le nombre par événement et le total de likes.

member

Un spectateur a rejoint la room. Se déclenche quand quelqu'un entre dans le live.

follow

Un spectateur a commencé à suivre le streamer pendant le live.

share

Un spectateur a partagé le live avec ses amis.

subscribe

Un spectateur s'est abonné au streamer.

roomUserSeq

Mise à jour du nombre de spectateurs. Nombre actuel et liste des meilleurs spectateurs.

battle

Événement battle/LinkMic. État du match, équipes, scores et participants.

battleArmies

Mise à jour des armées de battle avec les scores des équipes et le classement des participants.

roomPin

Un message du chat a été épinglé ou mis en avant par le streamer.

caption

Sous-titres automatiques natifs de TikTok pour le live, une fenêtre de sous-titre par frame.

envelope

Événement coffre au trésor ou enveloppe dans le live.

emote

Emote personnalisée envoyée dans le chat par un spectateur.

liveIntro

Mise à jour de l'intro du live - changements de titre et de description.

streamEnd

Le live est terminé. Inclut le code de raison.

connected

Connexion au live TikTok réussie.

error

Une erreur de connexion s'est produite. Inclut les détails de l'erreur.

Voir la référence complète des événements avec des exemples de payload →

Que peux-tu créer ?

Assistants de chat

Crée des assistants de chat automatiques qui répondent en temps réel aux messages, commandes et cadeaux des spectateurs.

Statistiques

Suis le nombre de spectateurs, le taux d'engagement, les revenus des cadeaux et l'activité du chat sur tous tes lives.

Jeux interactifs

Laisse les spectateurs contrôler le jeu avec des cadeaux, des commandes dans le chat et des likes.

Overlays de live

Crée des overlays OBS/Streamlabs qui affichent le chat, les alertes de cadeaux et les stats des spectateurs.

Repérage de créateurs

Suis les classements des créateurs, les top donateurs et les classements de ligue pour trouver et faire grandir des talents.

Apps mobiles

Crée des apps mobiles qui suivent les lives TikTok et interagissent avec eux.

Voir plus de cas d'usage →

TikTool vs Euler Stream vs tiktok-live-connector

Les bibliothèques open source tiktok-live-connector (Node.js) et TikTokLive (Python) sont maintenues par l'équipe qui gère Euler Stream. Ensemble, elles forment un écosystème bien suivi avec des clients sous licence MIT et un backend de signature managé. TikTool est une alternative managée indépendante, avec sa propre infrastructure de signature et d'autres priorités fonctionnelles.

FonctionnalitéTikToolTikTokLive (Python)tiktok-live-connectorEuler Stream
Service managé✓ 99,9 % de disponibilitéClient auto-hébergéClient auto-hébergé✓ Managé
SDK Node.js✓ Officiel✗✓ Officiel✓ eulerstream
SDK Python✓ Officiel✓ Officiel✗✓ via TikTokLive
Données agences (classements, ligues)✓✗✗✗
Données donateurs (LTV, profils types)✓✗✗✗
Classements en direct✓ Temps réel✗✗✗
Historique des battles + chronologie✓ Par match✗✗✗
Classements de ligue✓ Diamond Rush✗✗✗
Alertes en temps réel✓ Discord + Telegram✗✗✗
Sniper Gap (suivi des battles en direct)✓✗✗✗
CRM agence + listes de suivi✓✗✗✗
Pages de profil publiques (créateur + donateur)✓ Indexé✗✗✗
Offre gratuite✓ 5,000 req/jour✓ Licence MIT✓ Licence MIT✓ 1,000 req/jour
API WebSocket✓ Tous langagesPython uniquementNode.js uniquement✓
Gestion des CAPTCHA✓ IntégréVia un backend de signatureVia un backend de signature✓ Intégré

Tarifs et offre gratuite

Commence à développer avec l'API TikTok LIVE gratuitement. Sans carte bancaire.

OffreWebSocketRESTPrix
Sandbox3 simultanées (50/24 h)5,000/jourOffre Sandbox
Pro50 simultanées75,000/jour$15/semaine
Ultra250 simultanées300,000/jour$45/semaine
Agency500 + Firehose1,000,000/jour$119/semaine

Questions fréquentes

Existe-t-il une API publique pour les données de live ?

L'API TikTok LIVE est-elle gratuite ?

Quels langages de programmation l'API TikTok LIVE prend-elle en charge ?

En quoi TikTool diffère-t-il des bibliothèques open source pour les lives ?

Quelles données peut-on récupérer des lives TikTok ?

Quelle est la latence ?

Est-ce que je peux créer un assistant de chat TikTok LIVE ?

Combien de lives puis-je suivre en même temps ?

TikTool face à Euler Stream : quelles différences ?

TikTool est-il meilleur que TikFinity pour les développeurs ?

Peut-on utiliser l'API TikTok LIVE pour les statistiques de live ?

L'API TikTok LIVE fonctionne-t-elle avec OBS et Streamlabs ?