クイックスタートガイド
はじめての TikTok LIVE API
どのTikTok LIVE配信にも接続して、30秒以内にリアルタイムデータを受信。Sandboxプランなら、クレジットカードは不要です。
1
無料APIキーを取得
tik.tools/loginでGoogleアカウントを使って登録します。無料APIキーはすぐに発行されます。クレジットカードも審査も不要です。
Sandboxプランには5,000リクエスト/日とWebSocketの同時接続3本が含まれます（毎日50セッション、接続あたり2時間）。本番で使うなら有料プラン（$7/週から）にアップグレードすると、10,000リクエスト/日とWebSocketの同時接続20本を使えます。
2
SDKをインストール
npmからTikTools SDKをインストールします。Node.js、Bun、Denoで動きます。
npm install @tiktool/live3
ライブ配信に接続
SDKを使って、現在LIVE配信中のTikTokユーザーに接続します:
import { TikTokLive } from '@tiktool/live'
const client = new TikTokLive({
uniqueId: 'tv_asahi_news', // TikTok username (without @)
apiKey: process.env.TIKTOOL_API_KEY
})
// Listen for chat messages
client.on('chat', (event) => {
console.log(`[CHAT] ${event.nickname}: ${event.comment}`)
})
// Listen for gifts
client.on('gift', (event) => {
console.log(`[GIFT] ${event.nickname} sent ${event.giftName}`)
})
// Listen for viewer count updates
client.on('viewer_count', (event) => {
console.log(`[VIEWERS] ${event.viewerCount} watching`)
})
// Connect
await client.connect()
console.log('Connected! Listening for events...')4
実行
app.mjsとして保存して実行します:
TIKTOOL_API_KEY=your_key_here node app.mjs数秒でターミナルにライブイベントが流れ始めます:
[CHAT] john_doe: Hello everyone! 👋
[GIFT] cool_user sent Rose (1 diamonds)
[VIEWERS] 1,247 watching
[CHAT] fan_123: Love this stream!
[GIFT] big_spender sent Universe (34,000 diamonds)5
別の方法: 生のWebSocket
SDKを使いたくない場合は、どの言語からでもWebSocketで直接接続できます:
// WebSocket URL format:
wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY
// Every message is a JSON object:
{
"event": "chat",
"data": {
"comment": "Hello!",
"user": {
"uniqueId": "john_doe",
"nickname": "John",
"profilePictureUrl": "..."
}
}
}Python、Go、Rust、Java、C#、Rubyなど、WebSocketに対応したどの言語でも動きます。