TikTokLive

What it is and what it does

TikTokLive is an unofficial Python client that connects to TikTok livestreams and streams real-time events—comments, gifts, likes, follows, and other viewer interactions—by creator username. It wraps reverse-engineered TikTok APIs and uses WebSocket connections to receive live data. The library is built on httpx for HTTP requests, websockets for streaming, and protobuf for message serialization, and it supports both blocking (run()) and non-blocking (start()) connection modes.

The package is actively maintained but explicitly not production-ready; the author recommends the official Euler Stream WebSocket API for production deployments. It is useful for building chat bots, stream overlays, analytics tools, and other real-time integrations with TikTok livestreams, but users must accept the risk that reverse-engineered APIs can break without notice and that TikTok may impose connection limits or other restrictions.

Use it for:

• Build a chat bot that listens to comments and gifts in a TikTok livestream and responds or logs events in real time.
• Create a stream overlay or dashboard that displays live viewer interactions (comments, follows, gifts) for content creators.
• Aggregate and analyze TikTok livestream engagement metrics and viewer behavior for a single creator or multiple streams.
• Integrate TikTok livestream events into a unified chat or notification system alongside other streaming platforms.
• Develop a moderation or filtering tool that monitors and processes comments and user actions during a live broadcast.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Connect to TikTok livestreams and receive real-time events (chats, gifts, likes, follows) by creator username, using reverse-engineered unofficial APIs.

Yes, if you are building a hobby or experimental tool that needs real-time TikTok livestream data and can tolerate API instability. The library is actively maintained, has low install friction, and offers a straightforward event-driven API. However, do not use it for production systems—the author explicitly warns it is reverse-engineered and unstable. If you need reliability, use the official Euler Stream WebSocket API instead. Also verify that AGPL licensing aligns with your project's requirements.

Install

tiktoklive on PyPI

pip install tiktoklive

uv add tiktoklive

poetry add tiktoklive

Installing TikTokLive

Before you install

Low install friction with a pure-Python wheel. Actively maintained as of 2026-08-13 with 1525 repository stars. Requires 11 runtime dependencies including httpx, websockets_proxy, and protobuf libraries, which are standard ecosystem packages.

License in practice

Licensed under AGPL with permissive treatment classification. Verify your use case aligns with AGPL's copyleft requirements, particularly if integrating into proprietary or closed-source applications.

Quickstart

pip install TikTokLive

from TikTokLive import TikTokLiveClient
from TikTokLive.events import ConnectEvent, CommentEvent

client = TikTokLiveClient(unique_id="@creator_username")

@client.on(ConnectEvent)
async def on_connect(event: ConnectEvent):
    print(f"Connected to @{event.unique_id}")

client.run()

Requires Python 3.10 or later. This is a reverse-engineering project; the documentation notes it is not production-ready and recommends using the WebSocket API for production use.

Verify before relying

• Whether the reverse-engineered API remains stable across TikTok client updates or if frequent maintenance is required to maintain compatibility.
• Rate limiting, connection limits, or account restrictions that may apply when connecting to multiple livestreams or high-frequency polling.
• Whether proxy support (web_proxy, ws_proxy parameters) fully mitigates TikTok's connection restrictions or if additional measures are needed.

Package facts

Evidence: tiktoklive-6.6.6-py3-none-any.whl

Keywords: tiktok live api, tiktok api, tiktoklive, euler stream, tiktool, tiktok live, python3, api, unofficial

Tags

More Build Tools packages