Welche Analysedaten gibt es?
TikTok bietet keine öffentliche Analytics-API für LIVE-Streams. Die TikTools API schließt diese Lücke und liefert jedes Stream-Event in Echtzeit per WebSocket. Aus diesen Roh-Events kannst du jede Kennzahl berechnen:
- Zuschauerzahl - Zuschauerzahl in Echtzeit, Updates alle paar Sekunden
- Geschenkumsatz - jedes Geschenk-Event enthält den Diamantenwert (1 Diamant ≈ 0,005 $)
- Chat-Volumen - Nachrichten pro Minute, einzelne Chatter, Häufigkeit von Keywords
- Engagement-Rate - Likes, Shares, Follows pro Zeitraum
- Zuschauer-Spitzenwert - Höchstwerte über die gesamte Session verfolgen
- Geschenk-Rangliste - Top-Unterstützer nach insgesamt ausgegebenen Diamanten
Schnellstart: Dashboard-Daten in Echtzeit
Dieses Beispiel sammelt alle Analysedaten in Echtzeit. Bind es in ein beliebiges Frontend-Framework ein oder speicher es in einer Datenbank:
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)Erwartete Ausgabe
📊 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: 23In einer Datenbank speichern
Speicher Events für historische Auswertungen in PostgreSQL, MongoDB oder einer anderen Datenbank:
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...')Roher WebSocket (jede Sprache)
Bau Analysen in Python, Go, Rust oder jeder anderen Sprache mit WebSocket-Unterstützung:
# 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())FAQ
Hat TikTok eine offizielle Analytics-API für LIVE-Streams?
Nein. TikTok bietet Creatorn In-App-Analysen über das LIVE Center, aber keine öffentliche API, um programmatisch auf diese Daten zuzugreifen. Die TikTools API liefert Roh-Events in Echtzeit, mit denen du deine eigenen Analysen bauen kannst.
Kann ich mehrere Streams gleichzeitig tracken?
Ja. Erstell mehrere TikTokLive-Clients - einen pro Stream. Der Pro-Tarif unterstützt bis zu 50 gleichzeitige WebSocket-Verbindungen.
Wie genau ist die Zuschauerzahl?
Die Zuschauerzahl kommt direkt aus den internen Daten von TikTok und wird alle paar Sekunden aktualisiert. Sie entspricht der Zahl, die in der TikTok-App angezeigt wird.