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 :
Ton app se connecte
Ton app ouvre un WebSocket vers wss://api.tik.tools avec un pseudo TikTok et ta clé API.
TikTool fait le lien
TikTool trouve l'ID de la room, gère l'authentification, résout les vérifications et rejoint le live.
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/liveConnecte-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-apiConnecte-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 automaticallyTu 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_KEYChaque 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 :
chatMessage de chat d'un spectateur. Inclut les infos utilisateur, le texte du commentaire, les emotes et les badges.
giftCadeau 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.
likeUn spectateur a liké le live. Inclut le nombre par événement et le total de likes.
memberUn spectateur a rejoint la room. Se déclenche quand quelqu'un entre dans le live.
followUn spectateur a commencé à suivre le streamer pendant le live.
shareUn spectateur a partagé le live avec ses amis.
subscribeUn spectateur s'est abonné au streamer.
roomUserSeqMise à jour du nombre de spectateurs. Nombre actuel et liste des meilleurs spectateurs.
battleÉvénement battle/LinkMic. État du match, équipes, scores et participants.
battleArmiesMise à jour des armées de battle avec les scores des équipes et le classement des participants.
roomPinUn message du chat a été épinglé ou mis en avant par le streamer.
captionSous-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.
emoteEmote personnalisée envoyée dans le chat par un spectateur.
liveIntroMise à jour de l'intro du live - changements de titre et de description.
streamEndLe live est terminé. Inclut le code de raison.
connectedConnexion au live TikTok réussie.
errorUne 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.
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.
eulerstreamTarifs et offre gratuite
Commence à développer avec l'API TikTok LIVE gratuitement. Sans carte bancaire.