Ce este API-ul TikTok LIVE?
TikTok nu oferă un API public pentru datele din LIVE, cum ar fi chatul, cadourile sau numărul de spectatori. TikTok Business API acoperă doar reclamele și statisticile de shop. Pentru date LIVE în timp real, dezvoltatorii folosesc API-uri terțe.
Bibliotecile open-source tiktok-live-connector (Node.js) și TikTokLive (Python) au licență MIT și sunt gratuite. Ele deleagă semnarea TikTok unui backend; una dintre opțiunile implicite istorice este un serviciu de semnare plătit, construit de aceeași echipă care întreține bibliotecile.
TikTool este o alternativă independentă cu propria infrastructură de semnare. Este un API complet gestionat: menținerea conexiunii și autentificarea sunt gestionate de noi. O singură conexiune WebSocket livrează 90+ tipuri de evenimente - chat, cadouri, like-uri, urmăriri, spectatori, Meciuri LIVE și altele. SDK-uri oficiale pentru Node.js și Python. Plan Sandbox, fără card de credit.
Cum funcționează API-ul TikTok LIVE?
TikTool stă între aplicația ta și infrastructura de LIVE a TikTok. Iată arhitectura:
Aplicația ta se conectează
Aplicația ta deschide un WebSocket către wss://api.tik.tools cu un nume de utilizator TikTok și cheia ta API.
TikTool rezolvă conexiunea
TikTool identifică ID-ul camerei, se ocupă de autentificare, rezolvă verificările și intră în LIVE.
Evenimentele ajung la tine
Evenimentele în timp real (chat, cadouri, spectatori etc.) ajung în aplicația ta ca JSON curat - parsat, structurat și tipizat.
Nu lucrezi niciodată direct cu protocolul TikTok. Când TikTok își schimbă sistemele interne (ceea ce se întâmplă des), TikTool se adaptează - codul tău funcționează în continuare, neschimbat.
Start rapid - Node.js / TypeScript
Instalează SDK-ul oficial din npm:
npm install @tiktool/liveConectează-te la un LIVE și primește evenimente:
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();Suport complet TypeScript - fiecare tip de eveniment, câmp și parametru este tipizat, cu autocompletare în IDE. Citește ghidul complet Node.js →
Start rapid - Python
Instalează din PyPI:
pip install tiktok-live-apiConectează-te cu SDK-ul și înregistrează handlere cu decoratori:
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 automaticallyPreferi asyncio? await client.connect() rulează același client în propriul tău event loop. Cheia poate veni și din variabila de mediu TIKTOOL_API_KEY.
Citește ghidul complet Python →
Start rapid - WebSocket direct (orice limbaj)
Funcționează orice limbaj cu suport WebSocket - Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Conectează-te la:
wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEYFiecare mesaj este un obiect JSON cu câmpurile event și data. Date curate și structurate - fără parsare binară. Referința completă a API-ului WebSocket →
Toate tipurile de evenimente
API-ul TikTok LIVE transmite peste 18 evenimente în timp real din orice LIVE:
chatMesaj de chat de la un spectator. Include datele utilizatorului, textul comentariului, emote-urile și insignele.
giftCadou virtual trimis de un spectator. Include numele cadoului, valoarea în diamante, numărul de repetări și starea combo.
likeUn spectator a dat like LIVE-ului. Include numărul per eveniment și totalul de like-uri.
memberUn spectator a intrat în camera LIVE. Se declanșează când utilizatorii intră în LIVE.
followUn spectator a început să urmărească creatorul în timpul LIVE-ului.
shareUn spectator a distribuit LIVE-ul prietenilor.
subscribeUn spectator s-a abonat la creator.
roomUserSeqActualizarea numărului de spectatori. Numărul curent de spectatori și lista spectatorilor de top.
battleEveniment Meci LIVE/LinkMic. Starea meciului, echipele, scorurile și participanții.
battleArmiesActualizare a armatelor din Meciul LIVE, cu scorurile echipelor și clasamentul participanților.
roomPinUn mesaj din chat a fost fixat sau marcat de creator.
captionSubtitrări automate native TikTok pentru LIVE, câte o fereastră de subtitrare per cadru.
envelopeEveniment de cufăr cu comori sau plic în LIVE.
emoteEmote personalizat trimis în chat de un spectator.
liveIntroActualizarea introducerii LIVE-ului - modificări de titlu și descriere.
streamEndLIVE-ul s-a încheiat. Include codul motivului.
connectedConectare reușită la LIVE-ul TikTok.
errorA apărut o eroare de conexiune. Include detaliile erorii.
Vezi referința completă a evenimentelor, cu exemple de payload →
Ce poți construi?
Asistenți de chat
Construiește asistenți de chat automați care răspund în timp real la mesajele, comenzile și cadourile spectatorilor.
Statistici
Urmărește numărul de spectatori, rata de implicare, veniturile din cadouri și activitatea din chat pe mai multe LIVE-uri.
Jocuri interactive
Lasă spectatorii să controleze elemente din joc cu cadouri, comenzi în chat și like-uri.
Overlay-uri pentru LIVE
Creează overlay-uri pentru OBS/Streamlabs cu chat, alerte de cadouri și statistici despre spectatori.
Scouting de creatori
Urmărește clasamentele creatorilor, top gifterii și pozițiile din ligi ca să găsești și să crești talente.
Aplicații mobile
Construiește aplicații mobile care monitorizează LIVE-urile TikTok și interacționează cu ele.
Vezi mai multe cazuri de utilizare →
TikTool vs Euler Stream vs tiktok-live-connector
Bibliotecile open-source tiktok-live-connector (Node.js) și TikTokLive (Python) sunt întreținute de aceeași echipă care administrează Euler Stream. Împreună formează un ecosistem bine susținut, cu clienți cu licență MIT și un backend de semnare gestionat. TikTool este o alternativă gestionată independentă, cu propria infrastructură de semnare și un alt accent pe funcționalități.
eulerstreamPrețuri și plan gratuit
Începe gratuit să construiești cu API-ul TikTok LIVE. Fără card de credit.