快速開始指南
開始使用 TikTok LIVE API
30 秒內連上任何 TikTok LIVE 直播並接收即時資料。Sandbox 方案，不需要信用卡。
1
取得免費 API 金鑰
用 Google 帳號在 tik.tools/login 註冊。免費 API 金鑰立即產生，不用信用卡，也不用等審核。
Sandbox 方案包含 每天 5,000 次請求 和 3 個同時 WebSocket 連線（每天 50 個工作階段，每次連線 2 小時）。正式上線請升級付費方案（$7/週起），可享 每天 10,000 次請求 和 20 個同時 WebSocket 連線。
2
安裝 SDK
從 npm 安裝 TikTools SDK。支援 Node.js、Bun 和 Deno。
npm install @tiktool/live3
連上直播
用 SDK 連上任何正在直播的 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 的語言都行。