WebSocket API

TikTok LIVE
WebSocket API

チャット、ギフト、いいね、フォロー、視聴者数、バトルなど、TikTok LIVEのイベントを一本のマネージドWebSocket接続でリアルタイムに受信。50ms未満のレイテンシ。稼働率99.9%。

無料APIキーを取得ドキュメントを見る

wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY

<50msレイテンシ

99.9%稼働率

90+イベントの種類

すべて言語

3行のコードで接続

バイナリの解析も、インフラの手間も不要。WebSocket URL一つで、きれいなJSONが届きます。

import WebSocket from 'ws';

const ws = new WebSocket('wss://api.tik.tools?uniqueId=streamer&apiKey=YOUR_KEY');

ws.on('message', (raw) => {
  const msg = JSON.parse(raw);
  console.log(msg.event, msg.data);
});

すべてのイベントを見る

イベントを選ぶと、WebSocketで届く実際のJSONを各フィールドの説明付きで確認できます。

バーチャルギフト

event: "gift"

{
  "event": "gift",
  "data": {
    "user": {
      "uniqueId": "streamfan_22",
      "nickname": "Stream Fan",
      "userId": "6776543210987654321",
      "followRole": 2,
      "isSubscriber": true
    },
    "giftId": 5655,
    "giftName": "Rose",
    "diamondCount": 1,
    "repeatCount": 12,
    "repeatEnd": true,
    "groupId": "1718900000123",
    "giftType": 1,
    "receiverUserId": "6776000000000000010",
    "timestamp": 1718900000123
  }
}

giftNamestring送られたギフトの表示名。

diamondCountnumberギフト一個あたりのダイヤモンドの価値。

repeatCountnumberコンボで送られた個数。

repeatEndbooleanコンボが終了するとtrue - このフレームで合計してください。

userobject送信者のプロフィール: uniqueId、ニックネーム、フォローとサブスクライバーの状態。

receiverUserIdstringギフトを受け取ったクリエイター。マルチゲストLIVEでは特定のゲストまたはホストで、必ずしもルームのオーナーとは限りません。