TikTok LIVE API SDK for Python

TikTokLiveApiSdk is the official Python client for the EulerStream TikTok LIVE API. Connect to any TikTok LIVE stream by @username and receive real-time chat messages, gifts, likes, follows, shares, viewer counts, room stats and PK battles over a managed WebSocket, plus fully typed sync and async clients for LIVE rooms, creators, gifts, rankings, LIVE alerts, moderation and agencies.

EulerStream is the managed TikTok LIVE backend behind TikTokLive, the most popular Python library for TikTok LIVE. The connection layer is hosted and maintained for you, so your integration keeps working when TikTok changes its webcast protocol.

Unofficial: this project is not affiliated with, endorsed by, or connected to TikTok or ByteDance.

This package covers TikTok LIVE only. If you also need TikTok user profiles, videos, OAuth, request signing or captcha solving, install TikTokApiSdk instead: it is the same client with everything in this package plus those.

Installation

pip install TikTokLiveApiSdk

Requires Python 3.11+. Built on httpx and attrs; every endpoint has sync, sync_detailed, asyncio and asyncio_detailed variants and ships with full type hints (py.typed).

TikTok LIVE API quick start

1. Create a free EulerStream account (no credit card required)
2. Copy your API key from the dashboard
3. Make your first calls:

from TikTokLiveApiSdk import AuthenticatedClient
from TikTokLiveApiSdk.api.tik_tok_live import retrieve_hashtag_list
from TikTokLiveApiSdk.api.tik_tok_live_gifts import retrieve_webcast_gifts
from TikTokLiveApiSdk.api.tik_tok_live_rooms import fetch_webcast_url

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

with client as c:
    # List the hashtags TikTok LIVE streams are grouped under
    hashtags = retrieve_hashtag_list.sync(client=c)
    print(hashtags.message)

    # Get the TikTok LIVE gift list (names, diamond values, images) as a JSON file to download
    gifts = retrieve_webcast_gifts.sync(client=c)
    print(gifts.url)

    # Fetch the TikTok LIVE WebSocket URL + first payload for a LIVE room (protobuf)
    webcast = fetch_webcast_url.sync_detailed(room_id="7318296342189919018", client=c)
    print(webcast.status_code)

The same calls with asyncio:

import asyncio
from TikTokLiveApiSdk import AuthenticatedClient
from TikTokLiveApiSdk.api.tik_tok_live import retrieve_hashtag_list

async def main():
    async with AuthenticatedClient(base_url="https://api.eulerstream.com", token="YOUR_API_KEY") as c:
        hashtags = await retrieve_hashtag_list.asyncio(client=c)
        print(hashtags.message)

asyncio.run(main())

Business plans can resolve a LIVE room straight from the creator's @username with TikTokLiveApiSdk.api.tik_tok_live_anchors.fetch_webcast_url_by_unique_id. AuthenticatedClient sends your key in the X-Api-Key header; use TikTokLiveApiSdk.Client for the handful of routes that allow anonymous access.

What you can build with the TikTok LIVE API

• Live stream overlays for OBS and browser sources showing TikTok LIVE chat, gifts and top gifters
• Gift and follow alerts that trigger sounds, animations or webhooks in real time
• TikTok LIVE games controlled by chat commands or gifts
• Chatbots and moderation tools that respond to and moderate TikTok LIVE chat
• Analytics dashboards tracking diamonds, viewer retention and top supporters
• LIVE monitoring: bulk "is this creator live?" checks and LIVE start/end alerts for thousands of accounts

TikTok LIVE API coverage

Every TikTok LIVE path/method in the EulerStream OpenAPI spec becomes a module under TikTokLiveApiSdk.api.<group>, so the SDK always matches the live API.

Moderation and sending chat act as a TikTok account, so those calls take either an OAuth access token or a cookie header. OAuth tokens are issued by the TikTok OAuth routes, which are part of TikTokApiSdk.

Per-endpoint Python examples for every operation are in the EulerStream API docs.

Advanced usage

Customize the underlying httpx.Client / httpx.AsyncClient (timeouts, proxies, event hooks) through httpx_args, or replace it entirely:

import httpx
from TikTokLiveApiSdk import AuthenticatedClient

client = AuthenticatedClient(
    base_url="https://api.eulerstream.com",
    token="YOUR_API_KEY",
    timeout=httpx.Timeout(30),
    httpx_args={"proxy": "http://localhost:8030"},
)

See the docstrings on Client and AuthenticatedClient for every option, including verify_ssl, raise_on_unexpected_status and follow_redirects.

Migrating from EulerApiSdk

TikTokLiveApiSdk is the TikTok LIVE part of what used to be published as EulerApiSdk. Install it:

pip install TikTokLiveApiSdk

• Imports. Change EulerApiSdk to TikTokLiveApiSdk in your imports. The modules inside keep the names they had in EulerApiSdk 0.6.
• The old package can stay installed while you switch. The two share no files. Remove it with pip uninstall EulerApiSdk once nothing imports it.
• The non-LIVE modules moved out. User profiles, videos, OAuth, request signing, captcha solving and usage analytics are not in this package. They are in TikTokApiSdk, which has everything EulerApiSdk had. If you use any of them, install that instead; nothing else in your code has to change.

Other languages

The TikTok LIVE API SDK is also available for Node.js / TypeScript, C# / .NET, Java and Go, and anything else can use the language-agnostic WebSocket directly.

Links

• Website: eulerstream.com
• Documentation: eulerstream.com/docs
• OpenAPI reference: eulerstream.com/docs/openapi
• Pricing (free tier available): eulerstream.com/pricing
• Community: Discord
• Source and issues: github.com/EulerStream/TikTok-Api-Sdk

License

MIT © EulerStream