TikTok LIVE API (Unofficial)

The TikTok LIVE API allows you to connect to any TikTok LIVE stream and receive real-time chat messages, gifts, likes, follows, shares, viewer counts, room stats, and PK battles over a single managed WebSocket. Official SDKs for Node.js/TypeScript, Python, C#, Java, and Go. Powered by EulerStream, the managed backend behind the popular TikTokLive library.

Updated for 2026. Managed connections that keep working when TikTok changes. No protobuf parsing, no reverse engineering, no maintenance on your side.

---

Contents

• Why EulerStream
• SDKs & Supported Languages
• Quick Start
• TikTok LIVE Events
• Common Use Cases
• Community Libraries
• Plans & Pricing
• CI / Release Pipeline
• FAQ
• Enterprise
• Community
• License

---

Why EulerStream

TikTok does not publish an official public API for reading LIVE stream interaction data (chat, gifts, likes) in real time. EulerStream fills that gap with a managed API used in production for live overlays, stream alerts, TikTok LIVE games, chatbots, and analytics dashboards.

The core difference from self-hosted libraries is who carries the maintenance burden. Reverse-engineered connections break whenever TikTok updates its webcast protocol, and your own IP is exposed to TikTok directly. With EulerStream, the connection layer is hosted and maintained for you.

Full API documentation and the interactive OpenAPI spec live at eulerstream.com/docs.

---

SDKs & Supported Languages

Everything else can use the language-agnostic WebSocket directly. A payload decoder tool is available for debugging.

---

Quick Start

1. Create a free account (no credit card required)
2. Grab your API key from the dashboard
3. Install an SDK and connect

TypeScript / Node.js

import EulerStreamApiClient from "tiktok-live-api-sdk";

const client = new EulerStreamApiClient({ apiKey: "YOUR_API_KEY" });

// Look up any TikTok user by @username
const user = await client.tikTokUsers.retrieveTikTokUserBasic("tv_asahi_news");
console.log(user.data.user?.nickname);

// Browse the TikTok LIVE gift catalog
const catalog = await client.gifts.listWebcastGifts();
console.log(catalog.data.gifts?.length, "gifts");

// Business plan: fetch the TikTok LIVE WebSocket URL straight from the creator's @username
const webcast = await client.anchors.fetchWebcastURLByUniqueId("tv_asahi_news");

Python

from EulerApiSdk import AuthenticatedClient
from EulerApiSdk.api.tik_tok_users import retrieve_tik_tok_user_basic
from EulerApiSdk.api.tik_tok_live_gifts import list_webcast_gifts

client = AuthenticatedClient(base_url="https://api.eulerstream.com", token="YOUR_API_KEY")

with client as c:
    # Look up any TikTok user by @username
    user = retrieve_tik_tok_user_basic.sync(unique_id="tv_asahi_news", client=c)
    print(user.user.nickname)

    # Browse the TikTok LIVE gift catalog
    catalog = list_webcast_gifts.sync(client=c)
    print(len(catalog.gifts), "gifts")

Per-language SDK docs: TypeScript · Python · C# · Java · Go

---

TikTok LIVE Events

Subscribe to every real-time event from a TikTok LIVE stream using only the creator's @username:

• Chat messages: live comments from viewers
• Gifts: gift name, diamond count, combo/streak data
• Likes: like events and running like totals
• Follows: new followers during the stream
• Shares: stream share events
• Member / join: viewers entering the room
• Viewer count: live and peak viewer counts, room user stats
• Subscribe: new subscriptions
• PK battles: versus battles, scores, and results
• Room / stream state: LIVE start, LIVE end, and room info

Beyond the event stream, the REST API covers the gift catalog, room covers and video URLs, bulk live checks, creator leaderboards and rankings, and moderation actions (bans, mutes, sensitive words, moderator management). The full route catalog is on the pricing page.

---

Common Use Cases

• Live stream overlays: display chat, gifts, and top gifters on screen (OBS, browser sources)
• Gift & follow alerts: trigger sounds, animations, or webhooks on events
• TikTok LIVE games: build interactive, chat-controlled or gift-controlled live games
• Chatbots & moderation: respond to commands and moderate chat in real time
• Analytics: track gifts, diamonds, viewer retention, and top supporters
• Hardware integrations: anything you can wire up, like a thermal printer that prints gifts live

---

Community Libraries

Several popular open-source TikTok LIVE libraries integrate with EulerStream out of the box:

---

Plans & Pricing

Add-ons such as premium webcast routes, priority API requests, signature routes, CAPTCHA routes, and ranking catalog routes are available on paid plans. See eulerstream.com/pricing for current details.

---

CI / Release Pipeline

SDKs are generated via GitHub Actions from the OpenAPI document committed at spec/openapi.json. It is the public document the API server emits from its own source (openapi:emit -- --public in the euler-api-server app), so a release is generated from a reviewed, versioned spec rather than from whatever a running server happens to serve. Refresh it with scripts/refresh-spec.sh <path-to-euler-api-server-app>, which also refreshes the private SDK's full document, then commit the result.

Releases are triggered manually via the GitHub Actions "Run workflow" button. Nothing publishes automatically on push.

---

FAQ

Does TikTok have an official LIVE API for chat and gifts? No. TikTok does not offer an official public API for reading LIVE stream interaction data (chats, gifts, likes) in real time. EulerStream provides a managed API that connects to TikTok's LIVE (webcast) service so you can receive these events over a WebSocket.

How do I read TikTok LIVE chat and gifts in real time? Install an SDK above, add your API key, and subscribe to events for any streamer by their @username. Chat, gifts, likes, follows, viewer counts, and PK battle events arrive as they happen.

Which languages are supported? Node.js/TypeScript, Python, C#, Java, and Go, plus a language-agnostic WebSocket for everything else.

Is there a free tier? Yes. The Community tier is free forever and includes 2,500 requests per day, 25 cloud WebSockets, and 5 LIVE alerts. Higher limits and additional routes are available on the Business ($50/month) and Enterprise plans.

Is this affiliated with TikTok? No. This is an independent, unofficial third-party project. It is not affiliated with, endorsed by, or connected to TikTok or ByteDance.

---

Enterprise

---

Community

Questions, issues, or feedback? Join the EulerStream Discord or open a GitHub issue.

License

MIT