WebSocket API

TikTok LIVE
WebSocket API

Stream real-time TikTok LIVE events - chat, gifts, likes, follows, viewer counts, battles - through a single managed WebSocket connection.

wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY
Real-timeEvent delivery
90+Event Types
AnyLanguage

Connect in a few lines of code

No binary parsing, no infrastructure overhead. Just a WebSocket URL delivering clean 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);
});

Explore every event

Pick an event to see the exact JSON your WebSocket delivers, with each field explained.

Virtual Gifts

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
  }
}
giftNamestringDisplay name of the gift sent.
diamondCountnumberDiamond value of a single gift unit.
repeatCountnumberHow many were sent in the combo.
repeatEndbooleantrue when a streak has finished - sum on this frame.
userobjectSender profile: uniqueId, nickname, follow + subscriber status.
receiverUserIdstringThe creator the gift was sent to. In a multi-guest LIVE this is the specific guest/host, not always the room owner.

How TikTools compares

Side-by-side comparisons with other TikTok LIVE data providers, each dated and checked against their public pages.

See comparisons

Transparent Pricing

Evaluate free for 7 days, then pick the plan you need.

Pro
From $15/wk
  • Production request and WebSocket limits
  • Signed webhooks
  • Up to 50 concurrent live streams
View Plans
Ultra
From $45/wk
  • Highest limits below Agency
  • League boards unmasked
  • Every event type
View Plans

Works with every language

Official SDKs for Node.js and Python. WebSocket works with everything else.

Start streaming TikTok LIVE data today

Sandbox tier - 5,000 requests/day, 3 concurrent WebSocket connections. No credit card required.