API WebSocket

TikTok LIVE
API WebSocket

Recibe eventos de TikTok LIVE en tiempo real (chat, regalos, likes, follows, número de espectadores, batallas) a través de una sola conexión WebSocket gestionada. Latencia menor a 50ms. 99.9% de disponibilidad.

Obtén tu API key gratis Ver documentación

wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY

<50msLatencia

99.9%Disponibilidad

90+Tipos de eventos

CualquieraLenguaje

Conéctate en 3 líneas de código

Sin parsear binarios, sin cargar con infraestructura. Solo una URL WebSocket que entrega JSON limpio.

import WebSocket from 'ws';

const ws = new WebSocket('wss://api.tik.tools?uniqueId=streamer&apiKey=YOUR_KEY');

ws.on('message', (raw) => {
  const msg = JSON.parse(raw);
  console.log(msg.event, msg.data);
});

Explora cada evento

Elige un evento para ver el JSON exacto que entrega tu WebSocket, con cada campo explicado.

Regalos virtuales

event: "gift"

{
  "event": "gift",
  "data": {
    "user": {
      "uniqueId": "streamfan_22",
      "nickname": "Stream Fan",
      "userId": "6776543210987654321",
      "followRole": 2,
      "isSubscriber": true
    },
    "giftId": 5655,
    "giftName": "Rose",
    "diamondCount": 1,
    "repeatCount": 12,
    "repeatEnd": true,
    "groupId": "1718900000123",
    "giftType": 1,
    "receiverUserId": "6776000000000000010",
    "timestamp": 1718900000123
  }
}

giftNamestringNombre visible del regalo enviado.

diamondCountnumberValor en diamantes de una sola unidad del regalo.

repeatCountnumberCuántos se enviaron en el combo.

repeatEndbooleantrue cuando una racha terminó: suma en este frame.

userobjectPerfil del remitente: uniqueId, nickname, estado de seguidor y suscriptor.

receiverUserIdstringEl creador que recibió el regalo. En un LIVE con varios invitados es el invitado/host concreto, no siempre el dueño de la sala.