Hướng dẫn nhanh

Bắt đầu với TikTok LIVE API

Kết nối tới bất kỳ luồng TikTok LIVE nào và nhận dữ liệu thời gian thực chỉ trong vài phút. Gói Sandbox - không cần thẻ tín dụng.

1

Lấy key đánh giá

Đăng ký tại tik.tools/login bằng tài khoản Google. Key đánh giá 7 ngày được tạo ngay lập tức - không cần thẻ, không phải chờ duyệt.

Gói Sandbox gồm 5.000 request/ngày và 3 kết nối WebSocket đồng thời (50 phiên mỗi ngày, 2h mỗi kết nối). Nâng cấp lên gói trả phí (từ $7/tuần) để có 10.000 request/ngày và 20 kết nối WebSocket đồng thời cho production.

2

Cài SDK

Cài TikTools SDK từ npm. Chạy được với Node.js, Bun và Deno.

npm install @tiktool/live
3

Kết nối tới một phiên live

Dùng SDK để kết nối tới bất kỳ người dùng TikTok nào đang phát live:

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.user.nickname}: ${event.comment}`)
})

// Listen for gifts
client.on('gift', (event) => {
  console.log(`[GIFT] ${event.user.nickname} sent ${event.giftName} x${event.repeatCount} (${event.diamondCount * event.repeatCount} diamonds)`)
})

// Listen for viewer count updates
client.on('roomUserSeq', (event) => {
  console.log(`[VIEWERS] ${event.viewerCount} watching`)
})

// Connect
await client.connect()
console.log('Connected! Listening for events...')
4

Chạy thử

Lưu thành app.mjs rồi chạy:

TIKTOOL_API_KEY=your_key_here node app.mjs

Chỉ vài giây sau bạn sẽ thấy sự kiện live đổ về terminal:

[CHAT] john_doe: Hello everyone!
[GIFT] cool_user sent Rose x1 (1 diamonds)
[VIEWERS] 1247 watching
[CHAT] fan_123: Love this stream!
[GIFT] big_spender sent Universe x1 (34000 diamonds)
5

Cách khác: WebSocket thuần

Không muốn dùng SDK? Kết nối thẳng qua WebSocket từ bất kỳ ngôn ngữ nào:

// 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": "..."
    }
  }
}

Chạy với Python, Go, Rust, Java, C#, Ruby - mọi ngôn ngữ có hỗ trợ WebSocket.