TikTok LIVE API

Cos'è l'API di TikTok LIVE?

TikTok non offre un'API pubblica per i dati delle dirette come chat, regali o numero di spettatori. La TikTok Business API copre solo annunci e statistiche dello shop. Per accedere ai dati LIVE in tempo reale, gli sviluppatori usano API di terze parti.

Le librerie open source tiktok-live-connector (Node.js) e TikTokLive (Python) hanno licenza MIT e sono gratuite. Delegano la firma delle richieste TikTok a un backend; uno dei default storici è un servizio di firma a pagamento creato dallo stesso team che mantiene quelle librerie.

TikTool è un'alternativa indipendente con una propria infrastruttura di firma. È un'API completamente gestita: gestione della connessione e autenticazione sono a carico nostro. Una sola connessione WebSocket fornisce 90+ tipi di evento: chat, regali, like, follow, spettatori, sfide e altro. SDK ufficiali per Node.js e Python. Piano Sandbox, nessuna carta di credito richiesta.

Come funziona l'API di TikTok LIVE?

TikTool si trova tra la tua applicazione e l'infrastruttura di streaming live di TikTok. Ecco l'architettura:

Non devi mai toccare direttamente il protocollo di TikTok. Quando TikTok cambia i suoi sistemi interni (succede spesso), TikTool si adatta e il tuo codice continua a funzionare senza modifiche.

Avvio rapido - Node.js / TypeScript

Installa l'SDK ufficiale da npm:

npm install @tiktool/live

Collegati a una diretta e ricevi gli eventi:

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();

Supporto TypeScript completo: ogni tipo di evento, campo e parametro è tipizzato, con autocompletamento nel tuo IDE. Leggi la guida completa a Node.js →

Avvio rapido - Python

Installa da PyPI:

pip install tiktok-live-api

Collegati con l'SDK e registra gli handler con i 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 automatically

Preferisci asyncio? await client.connect() esegue lo stesso client nel tuo event loop. La chiave può arrivare anche dalla variabile d'ambiente TIKTOOL_API_KEY.

Leggi la guida completa a Python →

Avvio rapido - WebSocket diretto (qualsiasi linguaggio)

Funziona qualsiasi linguaggio con supporto WebSocket: Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Basta collegarsi a:

wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEY

Ogni messaggio è un oggetto JSON con i campi event e data. Dati puliti e strutturati, nessun parsing binario. Riferimento completo dell'API WebSocket →

Tutti i tipi di evento

L'API di TikTok LIVE trasmette oltre 18 eventi in tempo reale da qualsiasi diretta:

Vedi il riferimento completo degli eventi con payload di esempio →

Cosa puoi creare?

Vedi altri casi d'uso →

TikTool vs Euler Stream vs tiktok-live-connector

Le librerie open source tiktok-live-connector (Node.js) e TikTokLive (Python) sono mantenute dallo stesso team che gestisce Euler Stream. Insieme formano un ecosistema ben supportato, con client a licenza MIT e un backend di firma gestito. TikTool è un'alternativa gestita indipendente, con una propria infrastruttura di firma e un focus diverso sulle funzionalità.

Prezzi e piano gratuito

Inizia a sviluppare con l'API di TikTok LIVE gratis. Nessuna carta di credito richiesta.

Domande frequenti