How to Get TikTok Live Events in Python — Gifts, Chat, Follows

Summary — This tutorial walks you through connecting to any TikTok Live stream and receiving real-time events (gifts, chat messages, follows, shares, likes) using Python and the TikSync SDK. You'll go from zero to a working script in under 5 minutes — no headless browser, no proxy, no CAPTCHA.

Why TikSync Instead of TikTokLive?

If you've searched for "tiktok live python" before, you've probably found the open-source TikTokLive library. It works — sometimes. Under the hood, it relies on scraping TikTok's web page, which means it breaks every time TikTok updates their frontend, triggers CAPTCHAs on servers, and consumes hundreds of megabytes of RAM if it spins up a headless browser.

TikSync takes a fundamentally different approach. Instead of scraping, it uses a sign-only architecture built on 4 months of reverse engineering TikTok's binary protocol. Your Python script connects directly to TikTok's WebSocket servers using a cryptographic signature generated by TikSync's API — no browser, no proxy, no middleman for your data.

The best part: TikSync has a free tier with 1,000 API requests/day and 10 concurrent WebSocket connections. More than enough to build and test your project.

Installation

pip install tiksync

That's it. No Chromium download, no system dependencies. Works on Windows, macOS, and Linux.

You'll also need a TikSync API key. Grab one for free at tik-sync.com — it takes about 30 seconds.

Quick Start

from tiksync import TikSync



client = TikSync(api_key="your_api_key")



@client.on("chat")

def on_chat(event):

    print(f"{event.user.nickname}: {event.comment}")



client.connect("username")  # TikTok @username (without the @)

Run it, and you'll see live chat messages appearing in your terminal in real time.

Listening to Events

Chat Messages

@client.on("chat")

def on_chat(event):

    print(f"{event.user.nickname}: {event.comment}")

Gifts

@client.on("gift")

def on_gift(event):

    if event.repeat_end:

        total_coins = event.diamond_count * event.repeat_count

        print(f"{event.user.nickname} sent {event.gift_name} x{event.repeat_count} ({total_coins} coins)")

Follows

@client.on("follow")

def on_follow(event):

    print(f"New follower: {event.user.nickname}")

Shares, Likes, and Joins

@client.on("share")

def on_share(event):

    print(f"{event.user.nickname} shared the stream!")



@client.on("like")

def on_like(event):

    print(f"{event.user.nickname} liked ({event.total_likes} total)")



@client.on("member")

def on_member(event):

    print(f"{event.user.nickname} joined the stream")

Gift Tracking Example

from tiksync import TikSync

from collections import defaultdict



client = TikSync(api_key="your_api_key")

gift_totals = defaultdict(int)



@client.on("gift")

def on_gift(event):

    if event.repeat_end:

        coins = event.diamond_count * event.repeat_count

        gift_totals[event.user.unique_id] += coins

        print(f"[GIFT] {event.user.nickname} sent {event.gift_name} x{event.repeat_count} = {coins} coins")



@client.on("disconnect")

def on_disconnect():

    print("\nTop gifters this session:")

    for uid, total in sorted(gift_totals.items(), key=lambda x: -x[1])[:10]:

        print(f"  @{uid}: {total} coins")



client.connect("username")

Going to Production

Automatic Reconnection

client = TikSync(

    api_key="your_api_key",

    reconnect=True,

    reconnect_interval=5,

    max_reconnect_attempts=0  # unlimited

)

Async Support

import asyncio

from tiksync import AsyncTikSync



async def main():

    client = AsyncTikSync(api_key="your_api_key")



    @client.on("chat")

    async def on_chat(event):

        print(f"{event.user.nickname}: {event.comment}")



    await client.connect("username")



asyncio.run(main())

What You Can Build

• Chat bots that respond to commands in real time


• Gift leaderboards and alert systems


• Stream analytics dashboards


• Interactive games controlled by viewers


• Moderation tools


• Integrations with Discord, Twitch, OBS

TikSync's Python SDK handles all the complexity of TikTok's protocol so you can focus on building your product.

*Originally published at [tik-sync.com/blog/how-to-get-tiktok-live-events-python](https://tik-sync.com/blog/how-to-get-tiktok-live-events-python