tiktokapi

library7.3.3pypypi✓ verified 86d ago

TikTok-Api is an unofficial, asynchronous Python 3 wrapper for interacting with the TikTok API. It leverages Playwright for headless browser automation to bypass bot detection and fetch data. Currently at version 7.3.3, it has a frequent release cadence, often with minor updates, but also introduces significant changes to handle TikTok's evolving anti-bot measures.

http-networking

pip install tiktokapi

github ↗package ↗

INSTALL

IMPORT

SIG · TIKTOKAPI

tiktokapi

http-networkingpythonv7.3.3

Install

3.1s avg

Import

1017ms

Disk

110MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v3.6.3 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.718s · 57.6MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 4.3s · import 0.909s · 165MB

110MB installed

● package 110MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TikTokApi

✓ from TikTokApi import TikTokApi

This quickstart demonstrates how to fetch trending TikTok videos. It highlights the use of `ms_token` for authentication/stability and the asynchronous nature of the library. Remember to run `playwright install` first.

import asyncio from TikTokApi import TikTokApi import os async def main(): # It is highly recommended to provide an ms_token for stability and to bypass some bot detections. # You can get this from your browser's cookies when logged into TikTok. ms_token = os.environ.get("TIKTOK_MS_TOKEN", "your_ms_token_here") # For development/debugging, you might need to set headless=False to see the browser. # You might also need to install Playwright browsers: `playwright install`. async with TikTokApi(ms_token=ms_token, headless=True) as api: # Create sessions. For more robust usage, consider num_sessions > 1 and proxy_providers. await api.create_sessions(num_sessions=1, sleep_after_for_retry=False) print("Fetching trending videos...") async for video in api.trending.videos(count=5): print(f"Video ID: {video.id}") print(f"Author: {video.author.nickname} (@{video.author.unique_id})") print(f"Description: {video.desc[:70]}...") print(f"Play URL: {video.video.play_addr.uri}") print("-" * 30) if video.stats: print(f" Likes: {video.stats.digg_count}, Comments: {video.stats.comment_count}") if __name__ == "__main__": asyncio.run(main())

Debug

Known issues

breakingThe return type of `user().info` changed from an `Iterator[dict]` to an `Iterator[Playlist]` object.

fix

Update your code to expect and process `Playlist` objects instead of raw dictionaries when calling `user().info`.

affects: >=7.0.0

gotchaTikTok actively employs bot detection mechanisms. You may receive empty results or encounter `TikTokException` if detected.

fix

Use a valid `ms_token` (from your browser cookies), configure proxies (especially with `proxyproviders` for v7.2.0+), set `headless=False` during development/debugging, and consider using custom `browser_args` to mimic a real user.

affects: all

gotchaThe library is exclusively asynchronous, requiring `async/await` syntax and running within an `asyncio` event loop.

fix

Ensure all `TikTokApi` calls are `await`ed and your main script uses `asyncio.run()` or is part of an existing event loop.

affects: all

gotchaAfter `pip install tiktokapi`, you must also install the necessary Playwright browser binaries.

fix

Run `playwright install` in your terminal to download and configure the required browser engines (Chromium, Firefox, WebKit).

affects: all

gotchaWhile the library can sometimes function without it, providing a valid `ms_token` significantly improves stability and success rates, especially for logged-in user data or to bypass frequent bot detection.

fix

Obtain an `ms_token` from your browser's TikTok cookies and pass it to the `TikTokApi` constructor (e.g., `TikTokApi(ms_token='your_token')`).

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'playwright'

The `playwright` package, which is a core dependency, was not installed.

fix

Run `pip install playwright` to install the package.

playwright._impl._api_types.Error: No browser was found at specified location

The Playwright package is installed, but the necessary browser binaries (e.g., Chromium) have not been downloaded.

fix

Run `playwright install` in your terminal to download the required browsers.

RuntimeError: Event loop is closed

You are attempting to run asynchronous code outside of a properly managed `asyncio` event loop, or the loop has been prematurely closed.

fix

Wrap your asynchronous `TikTokApi` calls within an `async def` function and execute it using `asyncio.run(your_async_function())`.

TikTokApi.exceptions.TikTokException: Failed to create a session

TikTok's bot detection likely prevented the browser session from being established, or an invalid/expired `ms_token` was provided.

fix

Ensure you are using a valid, recent `ms_token`. Try `headless=False` for debugging. Consider using proxies and setting `num_sessions` to 1 initially for stability. Check your internet connection.

Received empty lists or unexpected lack of data from API calls (e.g., `api.trending.videos()` returns nothing).

This is often a symptom of TikTok's bot detection or aggressive rate limiting.

fix

Implement robust anti-bot strategies: use a valid `ms_token`, integrate with `proxyproviders` (v7.2.0+), try different `browser_args`, and consider adding delays between requests. Reducing `count` in data fetching methods might also help.

Upgrade

Version history

7.3.3latest on PyPI · released Apr 1, 2026

Audit

Dependencies

playwrightrequiredRequired for browser automation to interact with TikTok.

proxyprovidersoptionalOptional, but highly recommended for advanced proxy management and rotation (introduced in v7.2.0+).

Agent activity

10 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/davidteather/TikTok-Api ↗

packagehttps://pypi.org/project/tiktokapi/ ↗