TikTok LIVE API SDK for Python

EulerApiSdk 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 webcast signing, LIVE rooms, gifts, rankings, LIVE alerts, moderation, captchas and analytics.

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.

Installation

pip install EulerApiSdk

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).

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 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
from EulerApiSdk.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:
    # 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 (names, diamond values, images)
    catalog = list_webcast_gifts.sync(client=c)
    for gift in catalog.gifts:
        print(f"{gift.gift_name} = {gift.diamond_count} diamonds")

    # 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 EulerApiSdk import AuthenticatedClient
from EulerApiSdk.api.tik_tok_users import retrieve_tik_tok_user_basic


async def main():
    async with AuthenticatedClient(base_url="https://api.eulerstream.com", token="YOUR_API_KEY") as c:
        user = await retrieve_tik_tok_user_basic.asyncio(unique_id="tv_asahi_news", client=c)
        print(user.user.nickname)


asyncio.run(main())

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

What you can build

• 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

API coverage

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

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 EulerApiSdk 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.

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-Live-Api

License

MIT © EulerStream