TikTok LIVE API

¿Qué es la API de TikTok LIVE?

TikTok no ofrece una API pública para datos de transmisiones en vivo como el chat, los regalos o el número de espectadores. La TikTok Business API solo cubre anuncios y analíticas de la tienda. Para acceder a datos de LIVE en tiempo real, los desarrolladores usan APIs de terceros.

Las librerías de código abierto tiktok-live-connector (Node.js) y TikTokLive (Python) tienen licencia MIT y son de uso libre. Delegan la firma de TikTok a un backend; históricamente, una de las opciones por defecto ha sido un servicio de firma de pago creado por el mismo equipo que mantiene esas librerías.

TikTool es una alternativa independiente con su propia infraestructura de firma. Es una API totalmente gestionada: la conexión y la autenticación las resolvemos nosotros. Una sola conexión WebSocket entrega 90+ tipos de eventos: chat, regalos, likes, follows, espectadores, batallas y más. SDKs oficiales para Node.js y Python. Plan Sandbox, sin tarjeta de crédito.

¿Cómo funciona la API de TikTok LIVE?

TikTool se ubica entre tu aplicación y la infraestructura de transmisiones en vivo de TikTok. Esta es la arquitectura:

Nunca tienes que lidiar directamente con el protocolo de TikTok. Cuando TikTok cambia sus sistemas internos (algo que pasa seguido), TikTool se adapta y tu código sigue funcionando sin cambios.

Inicio rápido - Node.js / TypeScript

Instala el SDK oficial desde npm:

npm install @tiktool/live

Conéctate a una transmisión en vivo y recibe eventos:

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

Soporte completo de TypeScript: cada tipo de evento, campo y parámetro está tipado, con autocompletado en tu IDE. Lee la guía completa de Node.js →

Inicio rápido - Python

Instala desde PyPI:

pip install tiktok-live-api

Conéctate con el SDK y registra handlers con decoradores:

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

¿Prefieres asyncio? await client.connect() ejecuta el mismo cliente dentro de tu propio event loop. La key también puede venir de la variable de entorno TIKTOOL_API_KEY.

Lee la guía completa de Python →

Inicio rápido - WebSocket directo (cualquier lenguaje)

Funciona cualquier lenguaje con soporte de WebSocket: Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Solo conéctate a:

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

Cada mensaje es un objeto JSON con los campos event y data. Datos limpios y estructurados, sin parsear binarios. Referencia completa de la API WebSocket →

Todos los tipos de eventos

La API de TikTok LIVE transmite más de 18 eventos en tiempo real desde cualquier transmisión en vivo:

Ver la referencia completa de eventos con payloads de ejemplo →

¿Qué puedes crear?

Ver más casos de uso →

TikTool vs Euler Stream vs tiktok-live-connector

Las librerías de código abierto tiktok-live-connector (Node.js) y TikTokLive (Python) las mantiene el mismo equipo que opera Euler Stream. Juntas forman un ecosistema bien mantenido, con clientes con licencia MIT y un backend de firma gestionado. TikTool es una alternativa gestionada e independiente, con su propia infraestructura de firma y un enfoque de funciones distinto.

Precios y plan gratis

Empieza a construir con la API de TikTok LIVE gratis. Sin tarjeta de crédito.

Preguntas frecuentes