TikTok LIVE分析API - 視聴者、ギフト、エンゲージメントをリアルタイムで計測

どんな分析データが取れますか？

TikTokはLIVE配信の公開分析APIを提供していません。TikTools APIは、配信のあらゆるイベントをWebSocketでリアルタイムに届けることでこの穴を埋めます。生のイベントから、どんな指標でも計算できます:

視聴者数 - リアルタイムの視聴者数が数秒ごとに更新
ギフト収益 - すべてのギフトイベントにダイヤモンド価値が含まれます（1ダイヤモンド ≈ $0.005）
チャット量 - 毎分のメッセージ数、ユニークなチャット参加者、キーワードの出現頻度
エンゲージメント率 - 期間ごとのいいね、シェア、フォロー
最高視聴者数 - セッション中の最高記録を追跡
ギフトランキング - ダイヤモンドの合計額で並べたトップサポーター

クイックスタート: リアルタイムのダッシュボードデータ

この例では、すべての分析データをリアルタイムで収集します。どのフロントエンドフレームワークにも組み込めますし、データベースに保存することもできます:

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)

出力例

📊 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

データベースに保存

過去データの分析用に、イベントをPostgreSQL、MongoDBなど好きなデータベースに保存できます:

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（どの言語でも）

Python、Go、Rustなど、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())

FAQ

TikTokにはLIVE配信用の公式分析APIがありますか？

いいえ。TikTokはクリエイター向けにLIVEセンターでアプリ内の分析を提供していますが、このデータにプログラムからアクセスする公開APIはありません。TikTools APIは生のイベントをリアルタイムで届けるので、それを使って独自の分析を作れます。

複数の配信を同時に計測できますか？

はい。配信ごとにTikTokLiveクライアントを一つずつ作成してください。ProプランではWebSocketの同時接続を最大50本まで使えます。

視聴者数はどのくらい正確ですか？

視聴者数はTikTokの内部データから直接提供され、数秒ごとに更新されます。TikTokアプリに表示される数と一致します。

← イベントリファレンスすべてのイベントタイプを解説 Node.jsガイド →JavaScript/TypeScriptの完全ガイド

TikTok LIVE 分析API