TikTok LIVE API

什么是 TikTok LIVE API？

TikTok 并未提供用于获取弹幕、礼物、观众数等直播数据的公开 API。TikTok Business API 仅覆盖广告和电商分析。如需获取实时直播数据，开发者通常使用第三方 API。

开源库 tiktok-live-connector（Node.js）和 TikTokLive（Python）采用 MIT 许可，可免费使用。它们把 TikTok 签名交给后端处理，其历史默认选项之一是由维护这些库的同一团队打造的付费签名服务。

TikTool 是一款拥有自有签名基础设施的独立替代方案，属于全托管 API：连接维护与鉴权均在我们这边完成。一条 WebSocket 连接即可推送 90+ 种事件类型，包括弹幕、礼物、点赞、关注、观众、PK 等。提供 Node.js 和 Python 官方 SDK。Sandbox 套餐无需信用卡。

TikTok LIVE API 如何工作？

TikTool 位于你的应用与 TikTok 直播基础设施之间，架构如下：

你无需直接处理 TikTok 的协议。当 TikTok 调整内部系统时（这种情况很常见），TikTool 会及时适配，你的代码无需任何改动即可继续运行。

快速开始：Node.js / TypeScript

从 npm 安装官方 SDK：

npm install @tiktool/live

连接直播间并接收事件：

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();

完整的 TypeScript 支持：所有事件类型、字段和参数均有完整类型定义，可在 IDE 中自动补全。阅读完整 Node.js 指南 →

快速开始：Python

从 PyPI 安装：

pip install tiktok-live-api

使用 SDK 连接，并通过装饰器注册处理函数：

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

更喜欢 asyncio？await client.connect() 可在你自己的事件循环中运行同一个客户端。API Key 也可以从 TIKTOOL_API_KEY 环境变量读取。

阅读完整 Python 指南 →

快速开始：原生 WebSocket（任意语言）

任何支持 WebSocket 的语言都可以使用，包括 Go、Rust、Java、C#、Ruby、PHP、Dart、Kotlin、Swift。只需连接：

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

每条消息都是包含 event 和 data 字段的 JSON 对象。数据干净、结构化，无需解析二进制。完整 WebSocket API 参考 →

全部事件类型

TikTok LIVE API 可从任意直播间实时推送 18+ 种事件：

查看包含示例 payload 的完整事件参考 →

你可以构建什么？

查看更多使用场景 →

TikTool vs Euler Stream vs tiktok-live-connector

开源库 tiktok-live-connector（Node.js）和 TikTokLive（Python）由运营 Euler Stream 的同一团队维护。二者共同构成了一个维护良好的生态：MIT 许可的客户端加托管签名后端。TikTool 是一款独立的托管替代方案，拥有自有签名基础设施，功能侧重点也不同。

价格与免费套餐

免费开始使用 TikTok LIVE API 进行开发，无需信用卡。

常见问题