---
id: tiktoklive
version: "6.6.6"
license: AGPL
license_treatment: permissive
maintenance: active
---

# TikTokLive — TikTok Live Python Client

License: permissive · Maintenance: active · Downloads: 154.0K/mo

## 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 above — 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

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

- License: AGPL (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 154.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tiktok live chat api, tiktok livestream events, real-time tiktok notifications, tiktok live stream connector, tiktok api python, livestream chat listener, tiktok gifts and comments, reverse-engineered-api, livestream-events, async-websocket

[View on SkillFed](https://skillfed.io/packages/tiktoklive) · [View on PyPI](https://pypi.org/project/tiktoklive/)