Apa Itu API TikTok LIVE?
TikTok tidak menyediakan API publik untuk data siaran live seperti chat, hadiah, atau jumlah penonton. TikTok Business API hanya mencakup iklan dan analitik shop. Untuk mengakses data LIVE real-time, developer memakai API pihak ketiga.
Library open-source tiktok-live-connector (Node.js) dan TikTokLive (Python) berlisensi MIT dan gratis dipakai. Keduanya menyerahkan proses signing TikTok ke backend; salah satu default lamanya adalah layanan signing berbayar yang dibuat oleh tim yang sama yang mengelola library tersebut.
TikTool adalah alternatif independen dengan infrastruktur signing sendiri. API ini sepenuhnya terkelola: koneksi dan autentikasi kami tangani. Satu koneksi WebSocket mengirim 90+ jenis event - chat, hadiah, like, follow, penonton, LIVE match, dan lainnya. SDK resmi untuk Node.js dan Python. Paket Sandbox, tanpa kartu kredit.
Bagaimana Cara Kerja API TikTok LIVE?
TikTool berada di antara aplikasi kamu dan infrastruktur siaran live TikTok. Begini arsitekturnya:
Aplikasi Kamu Terhubung
Aplikasi kamu membuka WebSocket ke wss://api.tik.tools dengan username TikTok dan API key kamu.
TikTool Memproses
TikTool mencari room ID, menangani autentikasi, menyelesaikan tantangan, lalu bergabung ke siaran live.
Event Mengalir
Event real-time (chat, hadiah, penonton, dll.) dikirim ke aplikasi kamu sebagai JSON yang rapi - sudah diparse, terstruktur, dan bertipe.
Kamu tidak pernah berurusan langsung dengan protokol TikTok. Saat TikTok mengubah sistem internalnya (yang sering terjadi), TikTool menyesuaikan diri - kode kamu tetap jalan tanpa perubahan.
Mulai Cepat - Node.js / TypeScript
Instal SDK resmi dari npm:
npm install @tiktool/liveHubungkan ke siaran live dan terima event:
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();Dukungan TypeScript penuh - setiap jenis event, field, dan parameter sudah bertipe lengkap dengan autocomplete di IDE kamu. Baca panduan Node.js lengkap →
Mulai Cepat - Python
Instal dari PyPI:
pip install tiktok-live-apiHubungkan dengan SDK dan daftarkan handler pakai 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 automaticallyLebih suka asyncio? await client.connect() menjalankan client yang sama di dalam event loop kamu sendiri. Key juga bisa diambil dari environment variable TIKTOOL_API_KEY.
Mulai Cepat - WebSocket Langsung (Bahasa Apa Saja)
Bahasa apa pun yang mendukung WebSocket bisa dipakai - Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Cukup hubungkan ke:
wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEYSetiap pesan adalah objek JSON dengan field event dan data. Data rapi dan terstruktur - tanpa perlu parsing biner. Referensi API WebSocket lengkap →
Semua Jenis Event
API TikTok LIVE mengalirkan 18+ event real-time dari siaran live mana pun:
chatPesan chat dari penonton. Berisi info pengguna, teks komentar, emote, dan badge.
giftHadiah virtual yang dikirim penonton. Berisi nama hadiah, nilai berlian, jumlah pengulangan, dan status combo.
likePenonton memberi like ke siaran. Berisi jumlah per event dan total like.
memberPenonton bergabung ke room live. Terpicu saat pengguna masuk ke siaran.
followPenonton mengikuti streamer selama siaran live.
sharePenonton membagikan siaran live ke teman-temannya.
subscribePenonton berlangganan ke streamer.
roomUserSeqUpdate jumlah penonton. Jumlah penonton saat ini dan daftar penonton teratas.
battleEvent LIVE match/LinkMic. Status match, tim, skor, dan peserta.
battleArmiesUpdate pasukan LIVE match dengan skor tim dan peringkat peserta.
roomPinPesan chat disematkan atau diberi bintang oleh streamer.
captionTeks otomatis bawaan TikTok untuk siaran, satu jendela teks per frame.
envelopeEvent peti harta atau amplop di siaran.
emoteEmote kustom yang dikirim penonton di chat.
liveIntroUpdate intro siaran - perubahan judul dan deskripsi.
streamEndSiaran live telah berakhir. Berisi kode alasan.
connectedBerhasil terhubung ke siaran live TikTok.
errorTerjadi error koneksi. Berisi detail error.
Lihat referensi event lengkap dengan contoh payload →
Apa yang Bisa Kamu Buat?
Asisten Chat
Buat asisten chat otomatis yang merespons pesan, perintah, dan hadiah dari penonton secara real-time.
Analitik
Lacak jumlah penonton, tingkat engagement, pendapatan hadiah, dan aktivitas chat di berbagai siaran.
Game Interaktif
Biarkan penonton mengontrol elemen game lewat hadiah, perintah chat, dan like.
Overlay Siaran
Buat overlay OBS/Streamlabs yang menampilkan chat, notifikasi hadiah, dan statistik penonton.
Pencarian Kreator
Pantau ranking kreator, top gifter, dan klasemen liga untuk menemukan dan mengembangkan talenta.
Aplikasi Mobile
Buat aplikasi mobile yang memantau dan berinteraksi dengan siaran TikTok LIVE.
Lihat contoh penggunaan lainnya →
TikTool vs Euler Stream vs tiktok-live-connector
Library open-source tiktok-live-connector (Node.js) dan TikTokLive (Python) dikelola oleh tim yang sama yang menjalankan Euler Stream. Bersama-sama, keduanya membentuk ekosistem yang terawat baik dengan client berlisensi MIT dan backend signing terkelola. TikTool adalah alternatif terkelola independen dengan infrastruktur signing sendiri dan fokus fitur yang berbeda.
eulerstreamHarga & Paket Gratis
Mulai bikin dengan API TikTok LIVE secara gratis. Tanpa kartu kredit.