Hướng dẫn nhanh

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

Kết nối tới mọi phiên TikTok LIVE và nhận dữ liệu thời gian thực trong chưa đầy 30 giây. Gói Sandbox - không cần thẻ tín dụng.

1

Lấy API key miễn phí

Đăng ký tại tik.tools/login bằng tài khoản Google. API key miễn phí đượ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.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

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 (1 diamonds)
[VIEWERS] 1,247 watching
[CHAT] fan_123: Love this stream!
[GIFT] big_spender sent Universe (34,000 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.