API de analytics do TikTok LIVE - Acompanhe espectadores, presentes e engajamento em tempo real

Quais dados de analytics estão disponíveis?

O TikTok não oferece uma API pública de analytics para lives. A API do TikTools preenche essa lacuna entregando cada evento da live em tempo real via WebSocket. Você pode calcular qualquer métrica a partir desses eventos brutos:

Nº de espectadores - atualizações em tempo real a cada poucos segundos
Receita de presentes - todo evento de presente inclui o valor em diamantes (1 diamante ≈ $0,005)
Volume do chat - mensagens por minuto, pessoas únicas no chat, frequência de palavras-chave
Taxa de engajamento - curtidas, compartilhamentos e seguidores por período
Pico de audiência - acompanhe os recordes ao longo da sessão
Ranking de presentes - top apoiadores ordenados pelo total gasto em diamantes

Início rápido: dados de painel em tempo real

Este exemplo coleta todos os dados de analytics em tempo real. Conecte em qualquer framework de frontend ou salve em um banco de dados:

import { TikTokLive } from '@tiktool/live'

const client = new TikTokLive({
  uniqueId: 'target_username',
  apiKey: process.env.TIKTOOL_API_KEY
})

// ── Analytics State ──
const stats = {
  viewerCount: 0,
  peakViewers: 0,
  totalMessages: 0,
  totalGifts: 0,
  totalDiamonds: 0,
  totalLikes: 0,
  totalFollows: 0,
  totalShares: 0,
  uniqueChatters: new Set(),
  giftLeaderboard: new Map(),
  startTime: Date.now()
}

// Viewer count tracking
client.on('viewer_count', (event) => {
  stats.viewerCount = event.viewerCount
  if (event.viewerCount > stats.peakViewers) {
    stats.peakViewers = event.viewerCount
  }
})

// Chat analytics
client.on('chat', (event) => {
  stats.totalMessages++
  stats.uniqueChatters.add(event.userId)
})

// Gift revenue tracking
client.on('gift', (event) => {
  stats.totalGifts++
  stats.totalDiamonds += event.diamondCount

  const current = stats.giftLeaderboard.get(event.nickname) || 0
  stats.giftLeaderboard.set(event.nickname, current + event.diamondCount)
})

// Engagement tracking
client.on('like', (event) => {
  stats.totalLikes = event.totalLikeCount
})

client.on('follow', () => { stats.totalFollows++ })
client.on('share', () => { stats.totalShares++ })

await client.connect()
console.log('📊 Analytics tracking started!')

// Print summary every 60 seconds
setInterval(() => {
  const minutes = (Date.now() - stats.startTime) / 60000
  const revenue = (stats.totalDiamonds * 0.005).toFixed(2)

  console.log('\n── Stream Analytics ──')
  console.log(`Viewers: ${stats.viewerCount} (peak: ${stats.peakViewers})`)
  console.log(`Messages: ${stats.totalMessages} (${(stats.totalMessages / minutes).toFixed(1)}/min)`)
  console.log(`Unique chatters: ${stats.uniqueChatters.size}`)
  console.log(`Gifts: ${stats.totalGifts} (${stats.totalDiamonds} 💎 ≈ $${revenue})`)
  console.log(`Likes: ${stats.totalLikes} | Follows: ${stats.totalFollows} | Shares: ${stats.totalShares}`)
}, 60000)

Saída esperada

📊 Analytics tracking started!

── Stream Analytics ──
Viewers: 2,347 (peak: 3,891)
Messages: 487 (81.2/min)
Unique chatters: 203
Gifts: 34 (12,450 💎 ≈ $62.25)
Likes: 45,230 | Follows: 89 | Shares: 23

Salve em um banco de dados

Guarde os eventos em PostgreSQL, MongoDB ou qualquer banco de dados para análise histórica:

import { TikTokLive } from '@tiktool/live'

// Example: save to PostgreSQL with Prisma
import { PrismaClient } from '@prisma/client'
const prisma = new PrismaClient()

const client = new TikTokLive({
  uniqueId: 'target_username',
  apiKey: process.env.TIKTOOL_API_KEY
})

client.on('gift', async (event) => {
  await prisma.giftEvent.create({
    data: {
      streamer: 'target_username',
      senderNickname: event.nickname,
      senderUserId: event.userId,
      giftName: event.giftName,
      diamondCount: event.diamondCount,
      repeatCount: event.repeatCount,
      timestamp: new Date()
    }
  })
})

client.on('viewer_count', async (event) => {
  await prisma.viewerSnapshot.create({
    data: {
      streamer: 'target_username',
      viewerCount: event.viewerCount,
      timestamp: new Date()
    }
  })
})

await client.connect()
console.log('💾 Saving events to database...')

WebSocket puro (qualquer linguagem)

Crie analytics em Python, Go, Rust ou qualquer linguagem com suporte a WebSocket:

# Python example using websockets library
import asyncio, json, websockets

async def track_analytics():
    url = "wss://api.tik.tools?uniqueId=target_username&apiKey=YOUR_API_KEY"

    async with websockets.connect(url) as ws:
        total_diamonds = 0
        peak_viewers = 0

        async for raw in ws:
            msg = json.loads(raw)

            if msg["event"] == "viewer_count":
                viewers = msg["data"]["viewerCount"]
                peak_viewers = max(peak_viewers, viewers)
                print(f"Viewers: {viewers} (peak: {peak_viewers})")

            elif msg["event"] == "gift":
                diamonds = msg["data"]["diamondCount"]
                total_diamonds += diamonds
                revenue = total_diamonds * 0.005
                print(f"Gift revenue: {total_diamonds} 💎 (${revenue:.2f})")

asyncio.run(track_analytics())

Perguntas frequentes

O TikTok tem uma API oficial de analytics para lives?

Não. O TikTok oferece analytics dentro do app para criadores pelo LIVE Center, mas não existe uma API pública para acessar esses dados de forma programática. A API do TikTools entrega eventos brutos em tempo real que você pode usar para criar o seu próprio analytics.

Posso acompanhar várias lives ao mesmo tempo?

Pode. Crie vários clientes TikTokLive - um por live. O plano Pro suporta até 50 conexões WebSocket simultâneas.

Qual a precisão do número de espectadores?

O número de espectadores vem direto dos dados internos do TikTok e atualiza a cada poucos segundos. Ele bate com o número mostrado no app do TikTok.

← Referência de eventosTodos os tipos de evento documentados Guia de Node.js →Guia completo de JavaScript/TypeScript

TikTok LIVE API de analytics