davidteather/TikTok-Api — 6.8k★ on GitHub (Python). The Unofficial TikTok API Wrapper In Python
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This is an unofficial api wrapper for TikTok.com in python. With this api you are able to call most trending and fetch specific user information as well as much more.
This api is designed to retrieve data TikTok. It can not be used post or upload content to TikTok on the behalf of a user. It has no support for any user-authenticated routes, if you can't access it while being logged out on their website you can't access it here.
Sponsors
These sponsors have paid to be placed here or are my own affiliate links which I may earn a commission from, and beyond that I do not have any affiliation with them. The TikTokAPI package will always be free and open-source. If you wish to be a sponsor of this project check out my GitHub sponsors page.
TikAPI is a paid TikTok API service providing a full out-of-the-box solution, making life easier for developers — trusted by 500+ companies.
EnsembleData is the leading API provider for scraping Tiktok, Instagram, Youtube, and more. Trusted by the major influencer marketing and social media listening platforms.
Euler Stream is the #1 provider of TikTok API data for Enterprises & Agencies, trusted by 30,000+ customers. Our focus is on quick, stable APIs with world-class documentation & SDKs.
Cheap, Reliable Proxies: Supercharge your web scraping with fast, reliable proxies. Try 10 free datacenter proxies today!
Table of Contents
Documentation
Getting Started
How to Support The Project
Installing
Common Issues
Quick Start Guide
Examples
Documentation
You can find the full documentation here
Getting Started
To get started using this API follow the instructions below.
Note: If you want to learn how to web scrape websites check my free and open-source course for learning everything web scraping
How to Support The Project
Star the repo 😎
Consider sponsoring me on GitHub
Send me an email or a LinkedIn message telling me what you're using the API for, I really like hearing what people are using it for.
Submit PRs for issues :)
Installing
Note: Installation requires python3.9+
If you run into an issue please check the closed issues on the github, although feel free to re-open a new issue if you find an issue that's been closed for a few months. The codebase can and does run into similar issues as it has before, because TikTok changes things up.
If you would prefer a video walk through of setting up this package YouTube video just for that. (is a version out of date, installation is the same though)
If you want a quick video to listen for TikTok Live events in python.
Docker Installation
Clone this repository onto a local machine (or just the Dockerfile since it installs TikTokApi from pip) then run the following commands.
Note this assumes your script is named your_script.py and lives in the root of this directory.
Common Issues
EmptyResponseException - this means TikTok is blocking the request and detects you're a bot. This can be a problem with your setup or the library itself
you may need a proxy to successfully scrape TikTok, I've made a web scraping lesson explaining the differences of "tiers" of proxies, I've personally had success with webshare's residential proxies (affiliate link), but you might have success on their free data center IPs or a cheaper competitor.
not sure which proxy provider will work for you? This library integrates with my ProxyProviders package, which makes it easy to try out and switch between different proxy providers with a single line via create_sessions(proxy_provider=...). See examples/proxy_provider_example.py for usage.
Browser Has no Attribute - make sure you ran python3 -m playwright install, if your error persists try the playwright-python quickstart guide and diagnose issues from there.
API methods returning Coroutine - many of the API's methods are async so make sure your program awaits them for proper functionality
Quick Start Guide
Here's a quick bit of code to get the most recent trending videos on TikTok. There's more examples in the examples directory.
Note: If you want to learn how to web scrape websites check my free and open-source course for web scraping
from TikTokApi import TikTokApi
import asyncio
import os
ms_token = os.environ.get("ms_token", None) # get your own ms_token from your cookies on tiktok.com
async def trending_videos():
async with TikTokApi() as api:
await api.create_sessions(ms_tokens=[ms_token], num_sessions=1, sleep_after=3, browser=os.getenv("TIKTOK_BROWSER", "chromium"))
async for video in api.trending.videos(count=30):
print(video)
print(video.as_dict)
if __name__ == "__main__":
asyncio.run(trending_videos())
To directly run the example scripts from the repository root, use the -m option on python.
python -m examples.trending_example
You can access the full data dictionary the object was created from with .as_dict. On a video this may look like
this. TikTok changes their structure from time to time so it's worth investigating the structure of the dictionary when you use this package.
How active is development on davidteather/TikTok-Api?
The most recent commit recorded on davidteather/TikTok-Api was 4 months ago, based on the GitHub push timestamp. The repository has 1.2k forks — one of the better signals of community interest.
How many stars does davidteather/TikTok-Api have?
davidteather/TikTok-Api has 6.8k GitHub stars — refresh the page for the live number, or check github.com/davidteather/TikTok-Api. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is davidteather/TikTok-Api open source?
Yes — davidteather/TikTok-Api ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/davidteather/TikTok-Api.
What else is in the API space?
davidteather/TikTok-Api is tracked by TopGit under the API category, alongside 17 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What topics is davidteather/TikTok-Api associated with?
Where can I see davidteather/TikTok-Api in action?
The project maintains a homepage at https://davidteather.github.io/TikTok-Api. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about davidteather/TikTok-Api?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/davidteather/TikTok-Api is the definitive source.
Read full README in the tab above.
Want a second opinion on TikTok-Api?
Ask an AI that can read this page — one click and you get its take on TikTok-Api.