Τι είναι το TikTok LIVE API;
Το TikTok δεν προσφέρει δημόσιο API για δεδομένα live stream, όπως chat, δώρα ή αριθμό θεατών. Το TikTok Business API καλύπτει μόνο διαφημίσεις και analytics καταστημάτων. Για πρόσβαση σε δεδομένα LIVE σε πραγματικό χρόνο, οι developers χρησιμοποιούν APIs τρίτων.
Οι open-source βιβλιοθήκες tiktok-live-connector (Node.js) και TikTokLive (Python) έχουν άδεια MIT και είναι δωρεάν. Αναθέτουν το signing του TikTok σε ένα backend· μία από τις ιστορικές προεπιλογές είναι μια επί πληρωμή υπηρεσία signing από την ίδια ομάδα που συντηρεί αυτές τις βιβλιοθήκες.
Το TikTool είναι μια ανεξάρτητη εναλλακτική με δική της υποδομή signing. Είναι πλήρως managed API: τη σύνδεση και το authentication τα αναλαμβάνουμε εμείς. Μία σύνδεση WebSocket σού φέρνει 90+ τύπους events - chat, δώρα, likes, follows, θεατές, battles και άλλα. Επίσημα SDKs για Node.js και Python. Πακέτο Sandbox, χωρίς πιστωτική κάρτα.
Πώς λειτουργεί το TikTok LIVE API;
Το TikTool βρίσκεται ανάμεσα στην εφαρμογή σου και την υποδομή live streaming του TikTok. Αυτή είναι η αρχιτεκτονική:
Η εφαρμογή σου συνδέεται
Η εφαρμογή σου ανοίγει ένα WebSocket στο wss://api.tik.tools με ένα TikTok username και το API key σου.
Το TikTool αναλαμβάνει
Το TikTool βρίσκει το room ID, χειρίζεται το authentication, λύνει τα challenges και μπαίνει στο live stream.
Τα events καταφτάνουν
Τα events σε πραγματικό χρόνο (chat, δώρα, θεατές κ.λπ.) φτάνουν στην εφαρμογή σου ως καθαρό JSON - parsed, δομημένο και typed.
Δεν ασχολείσαι ποτέ απευθείας με το πρωτόκολλο του TikTok. Όταν το TikTok αλλάζει τα εσωτερικά του συστήματα (κάτι που γίνεται συχνά), το TikTool προσαρμόζεται - ο κώδικάς σου συνεχίζει να δουλεύει χωρίς αλλαγές.
Γρήγορη εκκίνηση - Node.js / TypeScript
Εγκατάστησε το επίσημο SDK από το npm:
npm install @tiktool/liveΣύνδεσου σε ένα live stream και λάβε events:
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();Πλήρης υποστήριξη TypeScript - κάθε τύπος event, πεδίο και παράμετρος είναι πλήρως typed, με autocomplete στο IDE σου. Διάβασε τον πλήρη οδηγό Node.js →
Γρήγορη εκκίνηση - Python
Εγκατάσταση από το PyPI:
pip install tiktok-live-apiΣύνδεσου με το SDK και δήλωσε handlers με decorators:
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Προτιμάς asyncio; Το await client.connect() τρέχει τον ίδιο client μέσα στο δικό σου event loop. Το key μπορεί να έρθει και από τη μεταβλητή περιβάλλοντος TIKTOOL_API_KEY.
Διάβασε τον πλήρη οδηγό Python →
Γρήγορη εκκίνηση - Raw WebSocket (οποιαδήποτε γλώσσα)
Δουλεύει με κάθε γλώσσα που υποστηρίζει WebSocket - Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Απλώς σύνδεσου στο:
wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEYΚάθε μήνυμα είναι ένα JSON object με πεδία event και data. Καθαρά, δομημένα δεδομένα - χωρίς binary parsing. Πλήρης αναφορά WebSocket API →
Όλοι οι τύποι events
Το TikTok LIVE API μεταδίδει 18+ events σε πραγματικό χρόνο από οποιοδήποτε live stream:
chatΜήνυμα chat από θεατή. Περιλαμβάνει στοιχεία χρήστη, κείμενο σχολίου, emotes και badges.
giftΕικονικό δώρο από θεατή. Περιλαμβάνει όνομα δώρου, αξία σε διαμάντια, αριθμό επαναλήψεων και κατάσταση combo.
likeΈνας θεατής έκανε like στο stream. Περιλαμβάνει πλήθος ανά event και σύνολο likes.
memberΈνας θεατής μπήκε στο live room. Στέλνεται κάθε φορά που κάποιος χρήστης μπαίνει στο stream.
followΈνας θεατής έκανε follow στον streamer κατά τη διάρκεια του live.
shareΈνας θεατής κοινοποίησε το live stream στους φίλους του.
subscribeΈνας θεατής έκανε συνδρομή στον streamer.
roomUserSeqΕνημέρωση αριθμού θεατών. Τρέχων αριθμός θεατών και λίστα top θεατών.
battleEvent Battle/LinkMic. Κατάσταση battle, ομάδες, σκορ και συμμετέχοντες.
battleArmiesΕνημέρωση battle armies με σκορ ομάδων και κατάταξη συμμετεχόντων.
roomPinΟ streamer καρφίτσωσε ή σημείωσε με αστέρι ένα μήνυμα chat.
captionΑυτόματοι υπότιτλοι του TikTok για το stream, ένα παράθυρο υποτίτλων ανά frame.
envelopeEvent με σεντούκι θησαυρού ή φάκελο στο stream.
emoteCustom emote που έστειλε θεατής στο chat.
liveIntroΕνημέρωση εισαγωγής stream - αλλαγές τίτλου και περιγραφής.
streamEndΤο live stream τελείωσε. Περιλαμβάνει τον κωδικό αιτίας.
connectedΕπιτυχής σύνδεση στο TikTok live stream.
errorΠροέκυψε σφάλμα σύνδεσης. Περιλαμβάνει λεπτομέρειες σφάλματος.
Δες την πλήρη αναφορά events με παραδείγματα payload →
Τι μπορείς να φτιάξεις;
Chat assistants
Φτιάξε αυτόματους chat assistants που απαντούν σε μηνύματα, εντολές και δώρα θεατών σε πραγματικό χρόνο.
Analytics
Παρακολούθησε θεατές, engagement, έσοδα από δώρα και δραστηριότητα chat σε όλα τα streams.
Διαδραστικά παιχνίδια
Άφησε τους θεατές να ελέγχουν στοιχεία του παιχνιδιού με δώρα, εντολές στο chat και likes.
Stream overlays
Φτιάξε overlays για OBS/Streamlabs με chat, ειδοποιήσεις δώρων και στατιστικά θεατών.
Scouting creators
Παρακολούθησε κατατάξεις creators, top gifters και βαθμολογίες λίγκας για να βρεις και να αναπτύξεις ταλέντα.
Εφαρμογές για κινητά
Φτιάξε εφαρμογές για κινητά που παρακολουθούν και αλληλεπιδρούν με TikTok LIVE streams.
TikTool vs Euler Stream vs tiktok-live-connector
Οι open-source βιβλιοθήκες tiktok-live-connector (Node.js) και TikTokLive (Python) συντηρούνται από την ίδια ομάδα που τρέχει το Euler Stream. Μαζί αποτελούν ένα καλά υποστηριζόμενο οικοσύστημα με clients υπό άδεια MIT και ένα managed backend signing. Το TikTool είναι μια ανεξάρτητη managed εναλλακτική με δική της υποδομή signing και διαφορετική εστίαση σε features.
eulerstreamΤιμές & δωρεάν πακέτο
Ξεκίνα δωρεάν με το TikTok LIVE API. Χωρίς πιστωτική κάρτα.