TikTok LIVE API

O que é a API do TikTok LIVE?

O TikTok não oferece uma API pública para dados de live, como chat, presentes ou número de espectadores. A TikTok Business API só cobre anúncios e analytics da loja. Para acessar dados da LIVE em tempo real, os devs usam APIs de terceiros.

As bibliotecas open source tiktok-live-connector (Node.js) e TikTokLive (Python) têm licença MIT e são grátis. Elas delegam a assinatura do TikTok para um backend; um dos padrões históricos é um serviço de assinatura pago, feito pela mesma equipe que mantém essas bibliotecas.

O TikTool é uma alternativa independente com infraestrutura de assinatura própria. É uma API totalmente gerenciada: a manutenção da conexão e a autenticação ficam do nosso lado. Uma conexão WebSocket entrega 90+ tipos de evento - chat, presentes, curtidas, seguidores, espectadores, batalhas e mais. SDKs oficiais para Node.js e Python. Plano Sandbox, sem cartão de crédito.

Como a API do TikTok LIVE funciona?

O TikTool fica entre o seu app e a infraestrutura de lives do TikTok. Olha a arquitetura:

Você nunca lida direto com o protocolo do TikTok. Quando o TikTok muda os sistemas internos (o que acontece direto), o TikTool se adapta - e o seu código continua funcionando sem mudar nada.

Início rápido - Node.js / TypeScript

Instale o SDK oficial pelo npm:

npm install @tiktool/live

Conecte numa live e receba os 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();

Suporte completo a TypeScript - todo tipo de evento, campo e parâmetro é tipado, com autocomplete na sua IDE. Leia o guia completo de Node.js →

Início rápido - Python

Instale pelo PyPI:

pip install tiktok-live-api

Conecte com o SDK e registre handlers com 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

Prefere asyncio? await client.connect() roda o mesmo cliente dentro do seu próprio event loop. A chave também pode vir da variável de ambiente TIKTOOL_API_KEY.

Leia o guia completo de Python →

Início rápido - WebSocket puro (qualquer linguagem)

Qualquer linguagem com suporte a WebSocket funciona - Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. É só conectar em:

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

Toda mensagem é um objeto JSON com os campos event e data. Dados limpos e estruturados - sem parsing binário. Referência completa da API WebSocket →

Todos os tipos de evento

A API do TikTok LIVE transmite mais de 18 eventos em tempo real de qualquer live:

Veja a referência completa de eventos com payloads de exemplo →

O que você pode criar?

Veja mais casos de uso →

TikTool vs Euler Stream vs tiktok-live-connector

As bibliotecas open source tiktok-live-connector (Node.js) e TikTokLive (Python) são mantidas pela mesma equipe que roda o Euler Stream. Juntas, elas formam um ecossistema bem suportado, com clientes de licença MIT e um backend de assinatura gerenciado. O TikTool é uma alternativa gerenciada independente, com infraestrutura de assinatura própria e um foco diferente de recursos.

Preços e plano grátis

Comece a criar com a API do TikTok LIVE de graça. Sem cartão de crédito.

Perguntas frequentes