TikTok LIVE API

TikTok LIVE API là gì?

TikTok không cung cấp API công khai cho dữ liệu livestream như chat, quà tặng hay số người xem. TikTok Business API chỉ bao gồm quảng cáo và thống kê shop. Để lấy dữ liệu LIVE theo thời gian thực, lập trình viên dùng API bên thứ ba.

Các thư viện mã nguồn mở tiktok-live-connector (Node.js) và TikTokLive (Python) dùng giấy phép MIT và miễn phí. Chúng giao việc ký request TikTok cho một backend; một trong các mặc định từ trước tới nay là dịch vụ ký trả phí do chính đội ngũ duy trì các thư viện đó xây dựng.

TikTool là một giải pháp thay thế độc lập với hạ tầng ký request riêng. Đây là API được quản lý hoàn toàn: duy trì kết nối và xác thực đều do chúng tôi xử lý. Một kết nối WebSocket mang về 90+ loại sự kiện - chat, quà tặng, like, follow, người xem, PK và nhiều hơn nữa. SDK chính thức cho Node.js và Python. Có gói Sandbox, không cần thẻ tín dụng.

TikTok LIVE API hoạt động thế nào?

TikTool đứng giữa ứng dụng của bạn và hạ tầng livestream của TikTok. Kiến trúc như sau:

Bạn không bao giờ phải làm việc trực tiếp với giao thức của TikTok. Khi TikTok thay đổi hệ thống nội bộ (chuyện xảy ra thường xuyên), TikTool tự thích ứng - code của bạn vẫn chạy bình thường mà không cần sửa.

Bắt đầu nhanh - Node.js / TypeScript

Cài SDK chính thức từ npm:

npm install @tiktool/live

Kết nối tới một phiên livestream và nhận sự kiện:

import { TikTokLive } from '@tiktool/live';

const client = new TikTokLive({
  uniqueId: 'streamer_username',
  apiKey: 'YOUR_API_KEY' // Get free key → https://tik.tools
});

client.on('chat', (event) => {
  console.log(`${event.user.uniqueId}: ${event.comment}`);
});

client.on('gift', (event) => {
  console.log(`${event.user.uniqueId} sent ${event.giftName} (${event.diamondCount} diamonds)`);
});

client.on('roomUserSeq', (event) => {
  console.log(`${event.viewerCount} viewers watching`);
});

client.connect();

Hỗ trợ TypeScript đầy đủ - mọi loại sự kiện, trường và tham số đều có kiểu, kèm gợi ý tự động trong IDE. Đọc hướng dẫn Node.js đầy đủ →

Bắt đầu nhanh - Python

Cài từ PyPI:

pip install tiktok-live-api

Kết nối bằng SDK và đăng ký handler bằng decorator:

from tiktok_live_api import TikTokLive

client = TikTokLive("streamer_username", api_key="YOUR_API_KEY")  # Get free key at https://tik.tools

@client.on("chat")
def on_chat(event):
    print(f"{event['user']['uniqueId']}: {event['comment']}")

@client.on("gift")
def on_gift(event):
    print(f"{event['user']['uniqueId']} sent {event['giftName']} ({event['diamondCount']} diamonds)")

@client.on("roomUserSeq")
def on_viewers(event):
    print(f"{event['viewerCount']} viewers watching")

client.run()  # blocks; reconnects automatically

Thích asyncio hơn? await client.connect() chạy cùng client đó trong event loop của riêng bạn. Key cũng có thể lấy từ biến môi trường TIKTOOL_API_KEY.

Đọc hướng dẫn Python đầy đủ →

Bắt đầu nhanh - WebSocket thuần (mọi ngôn ngữ)

Ngôn ngữ nào hỗ trợ WebSocket cũng dùng được - Go, Rust, Java, C#, Ruby, PHP, Dart, Kotlin, Swift. Chỉ cần kết nối tới:

wss://api.tik.tools?uniqueId=TIKTOK_USERNAME&apiKey=YOUR_API_KEY

Mỗi tin nhắn là một object JSON có hai trường event và data. Dữ liệu sạch, có cấu trúc - không cần parse nhị phân. Tài liệu tham chiếu WebSocket API đầy đủ →

Tất cả loại sự kiện

TikTok LIVE API stream hơn 18 sự kiện thời gian thực từ mọi phiên livestream:

Xem tài liệu sự kiện đầy đủ kèm payload mẫu →

Bạn có thể làm gì?

Xem thêm trường hợp sử dụng →

TikTool vs Euler Stream vs tiktok-live-connector

Các thư viện mã nguồn mở tiktok-live-connector (Node.js) và TikTokLive (Python) được duy trì bởi chính đội ngũ vận hành Euler Stream. Chúng tạo thành một hệ sinh thái được hỗ trợ tốt với client giấy phép MIT và backend ký request được quản lý. TikTool là giải pháp thay thế độc lập, được quản lý, có hạ tầng ký riêng và tập trung vào nhóm tính năng khác.

Bảng giá & gói miễn phí

Bắt đầu xây dựng với TikTok LIVE API miễn phí. Không cần thẻ tín dụng.

Câu hỏi thường gặp