TikTok LIVE API

TikTok LIVE APIとは？

TikTokは、チャット、ギフト、視聴者数といったLIVE配信データ向けの公開APIを提供していません。TikTok Business APIが対象とするのは広告とショップの分析だけです。リアルタイムのLIVEデータを扱うために、開発者はサードパーティのAPIを利用しています。

オープンソースライブラリのtiktok-live-connector（Node.js）とTikTokLive（Python）はMITライセンスで、無料で利用できます。これらはTikTokの署名処理をバックエンドに任せる設計で、従来のデフォルトの一つは、同じライブラリを開発しているチームによる有料の署名サービスです。

TikToolは独自の署名インフラを持つ独立した代替サービスです。フルマネージドのAPIなので、接続の維持と認証はすべてこちら側で処理します。一つのWebSocket接続で90+種類のイベントを受信できます。チャット、ギフト、いいね、フォロー、視聴者、バトルなどです。Node.jsとPythonの公式SDKを用意。Sandboxプランはクレジットカード不要です。

TikTok LIVE APIの仕組み

TikToolは、あなたのアプリケーションとTikTokのLIVE配信インフラの間に入ります。構成は次のとおりです。

TikTokのプロトコルを直接扱う必要はありません。TikTokが内部システムを変更しても（頻繁に起こります）、TikToolが対応するため、あなたのコードは変更なしで動き続けます。

クイックスタート - Node.js / TypeScript

npmから公式SDKをインストールします。

npm install @tiktool/live

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()で同じクライアントを自分のイベントループ内で実行できます。キーは環境変数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は、どのLIVE配信からも18種類以上のイベントをリアルタイムで配信します。

ペイロード例付きのイベントリファレンスを見る →

何が作れる？

その他のユースケースを見る →

TikTool vs Euler Stream vs tiktok-live-connector

オープンソースのtiktok-live-connector（Node.js）とTikTokLive（Python）は、Euler Streamを運営するチームがメンテナンスしています。MITライセンスのクライアントとマネージド署名バックエンドからなる、サポートの充実したエコシステムです。TikToolは独自の署名インフラを持つ独立したマネージド型の代替サービスで、機能の重点が異なります。

料金と無料プラン

TikTok LIVE APIを無料で使い始められます。クレジットカードは不要です。

よくある質問