Primeros pasos con la API de TikTok LIVE
Conéctate a cualquier transmisión de TikTok LIVE y recibe datos en tiempo real en menos de 30 segundos. Plan Sandbox, sin tarjeta de crédito.
Consigue tu API key gratis
Regístrate en tik.tools/login con tu cuenta de Google. Tu API key gratis se genera al instante: sin tarjeta de crédito ni proceso de aprobación.
El plan Sandbox incluye 5,000 solicitudes/día y 3 conexiones WebSocket simultáneas (50 sesiones al día, 2h por conexión). Mejora a un plan de pago (desde $7/semana) para tener 10,000 solicitudes/día y 20 conexiones WebSocket simultáneas en producción.
Instala el SDK
Instala el SDK de TikTools desde npm. Funciona con Node.js, Bun y Deno.
npm install @tiktool/liveConéctate a una transmisión en vivo
Usa el SDK para conectarte a cualquier usuario de TikTok que esté transmitiendo en vivo:
import { TikTokLive } from '@tiktool/live'
const client = new TikTokLive({
uniqueId: 'tv_asahi_news', // TikTok username (without @)
apiKey: process.env.TIKTOOL_API_KEY
})
// Listen for chat messages
client.on('chat', (event) => {
console.log(`[CHAT] ${event.nickname}: ${event.comment}`)
})
// Listen for gifts
client.on('gift', (event) => {
console.log(`[GIFT] ${event.nickname} sent ${event.giftName}`)
})
// Listen for viewer count updates
client.on('viewer_count', (event) => {
console.log(`[VIEWERS] ${event.viewerCount} watching`)
})
// Connect
await client.connect()
console.log('Connected! Listening for events...')Ejecútalo
Guárdalo como app.mjs y ejecuta:
TIKTOOL_API_KEY=your_key_here node app.mjsEn segundos verás los eventos en vivo llegando a tu terminal:
[CHAT] john_doe: Hello everyone! 👋
[GIFT] cool_user sent Rose (1 diamonds)
[VIEWERS] 1,247 watching
[CHAT] fan_123: Love this stream!
[GIFT] big_spender sent Universe (34,000 diamonds)Alternativa: WebSocket directo
¿No quieres usar el SDK? Conéctate directamente por WebSocket desde cualquier lenguaje:
// WebSocket URL format:
wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY
// Every message is a JSON object:
{
"event": "chat",
"data": {
"comment": "Hello!",
"user": {
"uniqueId": "john_doe",
"nickname": "John",
"profilePictureUrl": "..."
}
}
}Funciona con Python, Go, Rust, Java, C#, Ruby: cualquier lenguaje con soporte de WebSocket.