TikTok API SDK for Python

TikTokApiSdk is the official Python client for the EulerStream TikTok API. Use one typed TikTok API client, sync or async, to look up TikTok users and videos, run TikTok OAuth, sign TikTok web requests and solve TikTok captchas. The complete TikTok LIVE API is included as well, so the same client can read real-time LIVE chat, gifts and viewer counts.

The TikTok API behind this SDK is hosted by EulerStream, the managed TikTok backend behind TikTokLive, the most popular Python library for TikTok LIVE. Request signing, captcha solving and the LIVE connection layer are maintained for you, so your integration keeps working when TikTok changes.

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

Only need TikTok LIVE? TikTokLiveApiSdk is the same client with just the LIVE groups.

Installation

pip install TikTokApiSdk

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 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 TikTok API calls:

from TikTokApiSdk import AuthenticatedClient
from TikTokApiSdk.api.tik_tok_users import retrieve_tik_tok_user_basic
from TikTokApiSdk.api.tik_tok_videos import retrieve_tik_tok_video_basic
from TikTokApiSdk.api.tik_tok_live import retrieve_hashtag_list

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

with client as c:
    # TikTok users API: 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)

    # TikTok videos API: look up a TikTok video by its ID
    video = retrieve_tik_tok_video_basic.sync(video_id="7318296342189919018", client=c)
    print(video.message)

    # TikTok LIVE API (included): list the hashtags LIVE streams are grouped under
    hashtags = retrieve_hashtag_list.sync(client=c)
    print(hashtags.message)

The same TikTok API calls with asyncio:

import asyncio
from TikTokApiSdk import AuthenticatedClient
from TikTokApiSdk.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())

AuthenticatedClient sends your key in the X-Api-Key header; use TikTokApiSdk.Client for the handful of routes that allow anonymous access.

What the TikTok API covers

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

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

TikTok LIVE API included

Everything in TikTokLiveApiSdk is part of this package too:

What you can build with the TikTok API

• Creator lookups and profile tools backed by TikTok user profiles and the users catalog
• Video tools that fetch TikTok video details and thumbnails by ID
• "Sign in with TikTok" flows using the OAuth token, introspection and revocation routes
• Scrapers and data pipelines that sign TikTok web requests through the API instead of maintaining signature code
• Captcha handling for your own TikTok automation: puzzle, shapes, icon and whirl solvers
• Everything TikTok LIVE: stream overlays, gift alerts, chat bots, moderation tools and LIVE monitoring

Advanced usage

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

import httpx
from TikTokApiSdk 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

Coming from EulerApiSdk? This package is the same client with everything it had, under a new name. Install it, then change EulerApiSdk to TikTokApiSdk in your imports. The modules inside keep the names they had in EulerApiSdk 0.6.

pip install TikTokApiSdk

The old package can stay installed while you switch, because the two share no files. Remove it with pip uninstall EulerApiSdk once nothing imports it.

Other languages

The TikTok API SDK is also available for Node.js / TypeScript, C# / .NET, Java and Go, and anything else can call the TikTok API over plain HTTP.

Links

• Website: eulerstream.com
• TikTok API 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