Explore every event

See the exact JSON your socket delivers

Pick any of the 30+ real-time events - chat, gifts, battles, likes, viewers, captions - and read the precise payload with every 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.
The platform

One API. Every TikTok LIVE signal.

Real-time events, creator rankings, gaming and shopping boards, AI captions, and gifter intelligence - all from a single endpoint.

Copy-paste examples

Three working files. Pick a language. Run it.

No signup, no credit card, no npm install for HTML / Node 22. The demo key your_api_key is baked in - real free key + higher limits at tik.tools/login.

Live events monitor

Stream real-time chat, gifts, likes, follows + viewer counts from any TikTok LIVE creator via WebSocket.

Node.jsPythonHTML / JSLLM prompt
Works without signup
live-events-monitor.html
<!DOCTYPE html>
<!-- Save as live-events.html and double-click. No build step. No signup. -->
<meta charset="utf-8">
<title>Tik.Tools live events</title>
<style>
  body{font:14px ui-monospace,Menlo,monospace;background:#0a0a0c;color:#e4e4e7;padding:24px;max-width:760px;margin:0 auto}
  h1{font-size:18px;margin:0 0 8px}
  .bar{display:flex;gap:8px;margin:8px 0 14px}
  input,button{font:inherit;background:#14141a;color:#fff;border:1px solid #333;border-radius:6px;padding:6px 10px}
  button{background:#2a2a2a;border:n ...

Live video player

Play any TikTok LIVE stream in a standard <video> tag. Stream URLs come baked in to the public ticker - no extra auth call.

Node.jsPythonHTML / JSLLM prompt
Works without signup
live-video-player.html
<!DOCTYPE html>
<!-- Save as live-video.html and double-click. Public endpoint, no signup. -->
<meta charset="utf-8">
<title>Tik.Tools live video</title>
<style>
  body{margin:0;background:#000;color:#fff;font:14px system-ui}
  video{width:100%;max-width:900px;display:block;margin:0 auto;background:#000}
  .bar{display:flex;gap:8px;justify-content:center;padding:10px}
  input,button{font:inherit;background:#14141a;color:#fff;border:1px solid #333;border-radius:6px;padding:6px 10px}
  button{background:#2a2a2a;borde ...

Live top channels (public, no auth)

List 10 currently-live TikTok creators across the world. Free, rate-limited 1 call per 5 min per IP.

Node.jsPythonHTML / JSLLM prompt
Works without signup
live-top-channels-public-no-auth.html
<!DOCTYPE html>
<meta charset="utf-8">
<title>Tik.Tools top live channels</title>
<style>
  *{box-sizing:border-box}
  body{font:14px -apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0a0a0e;color:#e4e4e7;margin:0;padding:14px}
  .head{display:flex;justify-content:space-between;align-items:center;margin:0 0 10px;padding:0 4px}
  .head b{color:#fff;font-size:13px;font-weight:700;letter-spacing:.01em}
  .head .dot{display:inline-block;width:6px;height:6px;border-radius:50%;background:#22c55e;m ...
Demo limits 1 WebSocket / 10-min sessions / 6 connects per hour per IP. Need more? Get a free API key.
FAQ

Frequently Asked Questions About the TikTok LIVE API

Everything developers ask before building on the TikTok LIVE WebSocket - protocol, signing, pricing, language support.

Is there an official TikTok LIVE API?

Are TikTok LIVE libraries like tiktok-live-connector free?

What is the difference between Tik.Tools and Euler Stream?

How do I connect to a TikTok LIVE stream?

What data can I get from TikTok LIVE streams?

What programming languages work with TikTok LIVE API?