TikTok LIVE API Nedir?
TikTok, sohbet, hediyeler veya izleyici sayıları gibi canlı yayın verileri için herkese açık bir API sunmuyor. TikTok Business API yalnızca reklam ve mağaza analizlerini kapsıyor. Anlık CANLI verilere erişmek için geliştiriciler üçüncü taraf API'ler kullanıyor.
Açık kaynak kütüphaneler tiktok-live-connector (Node.js) ve TikTokLive (Python) MIT lisanslıdır ve ücretsiz kullanılabilir. TikTok imzalamasını bir backend'e devrederler; geçmişte varsayılan seçeneklerden biri, bu kütüphaneleri geliştiren ekibin kurduğu ücretli bir imzalama servisiydi.
TikTool, kendi imzalama altyapısına sahip bağımsız bir alternatif. Tamamen yönetilen bir API: bağlantı bakımı ve kimlik doğrulama bizim tarafımızda. Tek bir WebSocket bağlantısıyla 90+ olay türü gelir: sohbet, hediyeler, beğeniler, takipler, izleyiciler, PK'ler ve daha fazlası. Node.js ve Python için resmi SDK'lar. Sandbox planı, kredi kartı gerekmez.
TikTok LIVE API Nasıl Çalışır?
TikTool, uygulaman ile TikTok'un canlı yayın altyapısı arasında durur. Mimari şöyle:
Uygulaman Bağlanır
Uygulaman, bir TikTok kullanıcı adı ve API anahtarınla şu adrese WebSocket açar: wss://api.tik.tools
TikTool Odayı Bulur
TikTool oda kimliğini bulur, kimlik doğrulamayı yapar, doğrulama adımlarını çözer ve canlı yayına katılır.
Olaylar Akar
Anlık olaylar (sohbet, hediyeler, izleyiciler vb.) uygulamana temiz JSON olarak akar: ayrıştırılmış, yapılandırılmış ve tipli.
TikTok'un protokolüyle hiç doğrudan uğraşmazsın. TikTok iç sistemlerini değiştirdiğinde (ki bu sık olur) TikTool uyum sağlar; kodun hiç değişmeden çalışmaya devam eder.
Hızlı Başlangıç - Node.js / TypeScript
Resmi SDK'yı npm'den kur:
npm install @tiktool/liveBir canlı yayına bağlan ve olayları al:
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();Tam TypeScript desteği: her olay türü, alan ve parametre tamamen tipli, IDE'nde otomatik tamamlama ile. Node.js rehberinin tamamını oku →
Hızlı Başlangıç - Python
PyPI'dan kur:
pip install tiktok-live-apiSDK ile bağlan ve dekoratörlerle handler kaydet:
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 automaticallyasyncio mu tercih ediyorsun? await client.connect() aynı istemciyi kendi event loop'unun içinde çalıştırır. Anahtar ayrıca TIKTOOL_API_KEY ortam değişkeninden de okunabilir.
Python rehberinin tamamını oku →
Hızlı Başlangıç - Ham WebSocket (Her Dil)
WebSocket desteği olan her dil çalışır: Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Sadece şuraya bağlan:
wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEYHer mesaj, event ve data alanlarına sahip bir JSON nesnesidir. Temiz, yapılandırılmış veri; binary ayrıştırma gerekmez. WebSocket API referansının tamamı →
Tüm Olay Türleri
TikTok LIVE API, herhangi bir canlı yayından 18+ anlık olay akışı sağlar:
chatBir izleyiciden sohbet mesajı. Kullanıcı bilgisi, yorum metni, emote'lar ve rozetler dahil.
giftBir izleyicinin gönderdiği sanal hediye. Hediye adı, elmas değeri, tekrar sayısı ve kombo durumu dahil.
likeBir izleyici yayını beğendi. Olay başına sayı ve toplam beğeni dahil.
memberBir izleyici canlı odaya katıldı. Kullanıcılar yayına girdiğinde tetiklenir.
followBir izleyici canlı yayın sırasında yayıncıyı takip etti.
shareBir izleyici canlı yayını arkadaşlarıyla paylaştı.
subscribeBir izleyici yayıncıya abone oldu.
roomUserSeqİzleyici sayısı güncellemesi. Anlık izleyici sayısı ve öne çıkan izleyiciler listesi.
battlePK/LinkMic olayı. PK durumu, takımlar, skorlar ve katılımcılar.
battleArmiesTakım skorları ve katılımcı sıralamalarıyla PK ordusu güncellemesi.
roomPinYayıncı bir sohbet mesajını sabitledi veya yıldızladı.
captionYayın için TikTok'un kendi otomatik altyazıları, kare başına bir altyazı penceresi.
envelopeYayındaki hazine sandığı veya zarf olayı.
emoteBir izleyicinin sohbette gönderdiği özel emote.
liveIntroYayın tanıtımı güncellemesi: başlık ve açıklama değişiklikleri.
streamEndCanlı yayın sona erdi. Neden kodu dahil.
connectedTikTok canlı yayınına başarıyla bağlanıldı.
errorBağlantı hatası oluştu. Hata ayrıntıları dahil.
Örnek payload'larla tam olay referansını gör →
Neler Geliştirebilirsin?
Sohbet Asistanları
İzleyici mesajlarına, komutlara ve hediyelere anında yanıt veren otomatik sohbet asistanları geliştir.
Analiz
Yayınlar genelinde izleyici sayılarını, etkileşim oranlarını, hediye gelirini ve sohbet hareketliliğini takip et.
Etkileşimli Oyunlar
İzleyicilerin hediyeler, sohbet komutları ve beğenilerle oyun öğelerini kontrol etmesini sağla.
Yayın Overlay'leri
Sohbeti, hediye bildirimlerini ve izleyici istatistiklerini gösteren OBS/Streamlabs overlay'leri oluştur.
Yayıncı Keşfi
Yetenek bulmak ve büyütmek için yayıncı sıralamalarını, en büyük destekçileri ve lig durumlarını takip et.
Mobil Uygulamalar
TikTok canlı yayınlarını izleyen ve onlarla etkileşime giren mobil uygulamalar geliştir.
Daha fazla kullanım örneği gör →
TikTool, Euler Stream ve tiktok-live-connector karşılaştırması
Açık kaynak tiktok-live-connector (Node.js) ve TikTokLive (Python) kütüphanelerini, Euler Stream'i işleten ekip geliştiriyor. Birlikte, MIT lisanslı istemciler ve yönetilen bir imzalama backend'inden oluşan iyi desteklenen bir ekosistem oluşturuyorlar. TikTool ise kendi imzalama altyapısına ve farklı bir özellik odağına sahip bağımsız, yönetilen bir alternatif.
eulerstreamFiyatlar ve Ücretsiz Plan
TikTok LIVE API ile ücretsiz geliştirmeye başla. Kredi kartı gerekmez.