# Unofficial TikTok API in Python
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.
[](https://zenodo.org/badge/latestdoi/188710490) [](https://www.linkedin.com/in/davidteather/) [](https://github.com/sponsors/davidteather) [](https://github.com/davidteather/TikTok-Api/releases) [](https://github.com/davidteather/TikTok-Api/blob/main/LICENSE) [](https://pypi.org/project/TikTokApi/)  [](https://discord.gg/yyPhbfma6f)
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 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 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](https://github.com/sponsors/davidteather).
<div align="center">
<a href="https://tikapi.io/?ref=davidteather" target="_blank">
<img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/main/imgs/tikapi.png" width="100" alt="TikApi">
<div>
<b>TikAPI</b> is a paid TikTok API service providing a full out-of-the-box solution, making life easier for developers — trusted by 500+ companies.
</div>
</a>
<br>
<a href="https://www.ensembledata.com/?utm_source=github&utm_medium=githubpage&utm_campaign=david_thea_github&utm_id=david_thea_github" target="_blank">
<img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/main/imgs/EnsembleData.png" width="100" alt="Ensemble Data">
<b></b>
<div>
<b>EnsembleData</b> is the leading API provider for scraping Tiktok, Instagram, Youtube, and more. <br> Trusted by the major influencer marketing and social media listening platforms.
</div>
</a>
<br>
<a href="https://www.sadcaptcha.com?ref=davidteather" target="_blank">
<img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/main/imgs/tiktok_captcha_solver.png" width="100" alt="TikTok Captcha Solver">
<b></b>
<div>
<b>TikTok Captcha Solver: </b> Bypass any TikTok captcha in just two lines of code.<br> Scale your TikTok automation and get unblocked with SadCaptcha.
</div>
</a>
</div>
## Table of Contents
- [Documentation](#documentation)
- [Getting Started](#getting-started)
- [How to Support The Project](#how-to-support-the-project)
- [Installing](#installing)
- [Common Issues](#common-issues)
- [Quick Start Guide](#quick-start-guide)
- [Examples](https://github.com/davidteather/TikTok-Api/tree/main/examples)
[**Upgrading from V5 to V6**](#upgrading-from-v5-to-v6)
## Documentation
You can find the full documentation [here](https://davidteather.github.io/TikTok-Api)
## 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](https://github.com/davidteather/everything-web-scraping)
### How to Support The Project
- Star the repo 😎
- Consider [sponsoring](https://github.com/sponsors/davidteather) me on GitHub
- Send me an email or a [LinkedIn](https://www.linkedin.com/in/davidteather/) 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.
```sh
pip install TikTokApi
python -m playwright install
```
If you would prefer a video walk through of setting up this package [YouTube video](https://www.youtube.com/watch?v=-uCt1x8kINQ) 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](https://www.youtube.com/watch?v=307ijmA3_lc) 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.
```sh
docker pull mcr.microsoft.com/playwright:focal
docker build . -t tiktokapi:latest
docker run -v TikTokApi --rm tiktokapi:latest python3 your_script.py
```
**Note** this assumes your script is named your_script.py and lives in the root of this directory.
### Common Issues
Please don't open an issue if you're experiencing one of these just comment if the provided solution do not work for you.
- **Browser Has no Attribute** - make sure you ran `python3 -m playwright install`, if your error persists try the [playwright-python](https://github.com/microsoft/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](https://github.com/davidteather/TikTok-Api/tree/main/examples) directory.
**Note:** If you want to learn how to web scrape websites check my [free and open-source course for web scraping](https://github.com/davidteather/web-scraping-with-reverse-engineering)
```py
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)
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.
```sh
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](https://gist.github.com/davidteather/7c30780bbc30772ba11ec9e0b909e99d). TikTok changes their structure from time to time so it's worth investigating the structure of the dictionary when you use this package.
## Upgrading from V5 to V6
All changes will be noted on [V6.0.0](https://github.com/davidteather/TikTok-Api/releases/tag/V6.0.0) if you want more information.
### Changes & Motivations
- Maintainability
- Was getting difficult to maintain with how TikTok was directly detecting HTTP requests.
- Switched to using a pool of **async** playwright pages to make it more difficult to detect, and hopefully easier to maintain in the future
- Async
- It's been asked for a lot, and now fully async needed especially since the package is using a pool of playwright instances
- User Flexibility
- Added a lot of function argument options that should be much more explicit than what was done previously.
- Hopefully if something is broken there's a workaround without having to modify the package itself (although if you do notice an issue please open an issue or submit a PR)
- Documentation
- Goes with user flexibility a little bit but switched over to sphinx documentation for more explicit content
- If you run into an issue or are confused please open a github issue or submit a PR to fix documentation, it's always welcome! 🤠
### Upgrading Examples
The biggest change is that everything is now async. You can see above how you might want to call an async function in python as well as the examples directory for more examples.
Raw data
{
"_id": null,
"home_page": "https://github.com/davidteather/tiktok-api",
"name": "TikTokApi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "tiktok, python3, api, unofficial, tiktok-api, tiktok api",
"author": "David Teather",
"author_email": "contact.davidteather@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/09/26/dfe24c266fa954b4e9ca7bf5b45fe16226ee71cbbc9619f67592d89f7ad1/tiktokapi-6.5.2.tar.gz",
"platform": null,
"description": "# Unofficial TikTok API in Python\n\nThis 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.\n\n[](https://zenodo.org/badge/latestdoi/188710490) [](https://www.linkedin.com/in/davidteather/) [](https://github.com/sponsors/davidteather) [](https://github.com/davidteather/TikTok-Api/releases) [](https://github.com/davidteather/TikTok-Api/blob/main/LICENSE) [](https://pypi.org/project/TikTokApi/)  [](https://discord.gg/yyPhbfma6f)\n\nThis 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 any user-authenticated routes**, if you can't access it while being logged out on their website you can't access it here.\n\n## Sponsors\n\nThese sponsors have paid to be placed here 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](https://github.com/sponsors/davidteather).\n\n<div align=\"center\">\n <a href=\"https://tikapi.io/?ref=davidteather\" target=\"_blank\">\n <img src=\"https://raw.githubusercontent.com/davidteather/TikTok-Api/main/imgs/tikapi.png\" width=\"100\" alt=\"TikApi\">\n <div>\n <b>TikAPI</b> is a paid TikTok API service providing a full out-of-the-box solution, making life easier for developers \u2014 trusted by 500+ companies.\n </div>\n </a>\n <br>\n <a href=\"https://www.ensembledata.com/?utm_source=github&utm_medium=githubpage&utm_campaign=david_thea_github&utm_id=david_thea_github\" target=\"_blank\">\n <img src=\"https://raw.githubusercontent.com/davidteather/TikTok-Api/main/imgs/EnsembleData.png\" width=\"100\" alt=\"Ensemble Data\">\n <b></b>\n <div>\n <b>EnsembleData</b> is the leading API provider for scraping Tiktok, Instagram, Youtube, and more. <br> Trusted by the major influencer marketing and social media listening platforms.\n </div>\n </a>\n <br>\n <a href=\"https://www.sadcaptcha.com?ref=davidteather\" target=\"_blank\">\n <img src=\"https://raw.githubusercontent.com/davidteather/TikTok-Api/main/imgs/tiktok_captcha_solver.png\" width=\"100\" alt=\"TikTok Captcha Solver\">\n <b></b>\n <div>\n <b>TikTok Captcha Solver: </b> Bypass any TikTok captcha in just two lines of code.<br> Scale your TikTok automation and get unblocked with SadCaptcha.\n </div>\n </a>\n</div>\n\n## Table of Contents\n\n- [Documentation](#documentation)\n- [Getting Started](#getting-started)\n - [How to Support The Project](#how-to-support-the-project)\n - [Installing](#installing)\n - [Common Issues](#common-issues)\n- [Quick Start Guide](#quick-start-guide)\n - [Examples](https://github.com/davidteather/TikTok-Api/tree/main/examples)\n\n[**Upgrading from V5 to V6**](#upgrading-from-v5-to-v6)\n\n## Documentation\n\nYou can find the full documentation [here](https://davidteather.github.io/TikTok-Api)\n\n## Getting Started\n\nTo get started using this API follow the instructions below.\n\n**Note:** If you want to learn how to web scrape websites check my [free and open-source course for learning everything web scraping](https://github.com/davidteather/everything-web-scraping)\n\n### How to Support The Project\n\n- Star the repo \ud83d\ude0e\n- Consider [sponsoring](https://github.com/sponsors/davidteather) me on GitHub\n- Send me an email or a [LinkedIn](https://www.linkedin.com/in/davidteather/) message telling me what you're using the API for, I really like hearing what people are using it for.\n- Submit PRs for issues :)\n\n### Installing\n\n**Note:** Installation requires python3.9+\n\nIf 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.\n\n```sh\npip install TikTokApi\npython -m playwright install\n```\n\nIf you would prefer a video walk through of setting up this package [YouTube video](https://www.youtube.com/watch?v=-uCt1x8kINQ) just for that. (is a version out of date, installation is the same though)\n\nIf you want a quick video to listen for [TikTok Live](https://www.youtube.com/watch?v=307ijmA3_lc) events in python.\n\n#### Docker Installation\n\nClone this repository onto a local machine (or just the Dockerfile since it installs TikTokApi from pip) then run the following commands.\n\n```sh\ndocker pull mcr.microsoft.com/playwright:focal\ndocker build . -t tiktokapi:latest\ndocker run -v TikTokApi --rm tiktokapi:latest python3 your_script.py\n```\n\n**Note** this assumes your script is named your_script.py and lives in the root of this directory.\n\n### Common Issues\n\nPlease don't open an issue if you're experiencing one of these just comment if the provided solution do not work for you.\n\n- **Browser Has no Attribute** - make sure you ran `python3 -m playwright install`, if your error persists try the [playwright-python](https://github.com/microsoft/playwright-python) quickstart guide and diagnose issues from there.\n\n- **API methods returning Coroutine** - many of the API's methods are async so make sure your program awaits them for proper functionality\n\n## Quick Start Guide\n\nHere's a quick bit of code to get the most recent trending videos on TikTok. There's more examples in the [examples](https://github.com/davidteather/TikTok-Api/tree/main/examples) directory.\n\n**Note:** If you want to learn how to web scrape websites check my [free and open-source course for web scraping](https://github.com/davidteather/web-scraping-with-reverse-engineering)\n\n```py\nfrom TikTokApi import TikTokApi\nimport asyncio\nimport os\n\nms_token = os.environ.get(\"ms_token\", None) # get your own ms_token from your cookies on tiktok.com\n\nasync def trending_videos():\n async with TikTokApi() as api:\n await api.create_sessions(ms_tokens=[ms_token], num_sessions=1, sleep_after=3)\n async for video in api.trending.videos(count=30):\n print(video)\n print(video.as_dict)\n\nif __name__ == \"__main__\":\n asyncio.run(trending_videos())\n```\n\nTo directly run the example scripts from the repository root, use the `-m` option on python.\n\n```sh\npython -m examples.trending_example\n```\n\nYou can access the full data dictionary the object was created from with `.as_dict`. On a video this may look like\n[this](https://gist.github.com/davidteather/7c30780bbc30772ba11ec9e0b909e99d). TikTok changes their structure from time to time so it's worth investigating the structure of the dictionary when you use this package.\n\n## Upgrading from V5 to V6\n\nAll changes will be noted on [V6.0.0](https://github.com/davidteather/TikTok-Api/releases/tag/V6.0.0) if you want more information.\n\n### Changes & Motivations\n\n- Maintainability\n - Was getting difficult to maintain with how TikTok was directly detecting HTTP requests.\n - Switched to using a pool of **async** playwright pages to make it more difficult to detect, and hopefully easier to maintain in the future\n- Async\n - It's been asked for a lot, and now fully async needed especially since the package is using a pool of playwright instances\n- User Flexibility\n - Added a lot of function argument options that should be much more explicit than what was done previously.\n - Hopefully if something is broken there's a workaround without having to modify the package itself (although if you do notice an issue please open an issue or submit a PR)\n- Documentation\n - Goes with user flexibility a little bit but switched over to sphinx documentation for more explicit content\n - If you run into an issue or are confused please open a github issue or submit a PR to fix documentation, it's always welcome! \ud83e\udd20\n\n### Upgrading Examples\n\nThe biggest change is that everything is now async. You can see above how you might want to call an async function in python as well as the examples directory for more examples.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The Unofficial TikTok API Wrapper in Python 3.",
"version": "6.5.2",
"project_urls": {
"Download": "https://github.com/davidteather/TikTok-Api/tarball/main",
"Homepage": "https://github.com/davidteather/tiktok-api"
},
"split_keywords": [
"tiktok",
" python3",
" api",
" unofficial",
" tiktok-api",
" tiktok api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a2bdbf43fee22d250120abcb18cd11075b40c8c98847414e8211ea87b24824e8",
"md5": "4eb5d9d541364ba305733c03c6eb71b6",
"sha256": "e512a6800ca909b20758de1a5e92851be9a9ccdd3f06770dbf85c2019f592880"
},
"downloads": -1,
"filename": "TikTokApi-6.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4eb5d9d541364ba305733c03c6eb71b6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 52261,
"upload_time": "2024-08-24T18:13:52",
"upload_time_iso_8601": "2024-08-24T18:13:52.264320Z",
"url": "https://files.pythonhosted.org/packages/a2/bd/bf43fee22d250120abcb18cd11075b40c8c98847414e8211ea87b24824e8/TikTokApi-6.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0926dfe24c266fa954b4e9ca7bf5b45fe16226ee71cbbc9619f67592d89f7ad1",
"md5": "118937e48153811682ab33f68c2c0288",
"sha256": "33f96d7cdf80e491507f4295fa6ba22813d1f0a4d6c3f9d3ffaf249622568ac2"
},
"downloads": -1,
"filename": "tiktokapi-6.5.2.tar.gz",
"has_sig": false,
"md5_digest": "118937e48153811682ab33f68c2c0288",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 39293,
"upload_time": "2024-08-24T18:13:53",
"upload_time_iso_8601": "2024-08-24T18:13:53.938595Z",
"url": "https://files.pythonhosted.org/packages/09/26/dfe24c266fa954b4e9ca7bf5b45fe16226ee71cbbc9619f67592d89f7ad1/tiktokapi-6.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-24 18:13:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "davidteather",
"github_project": "tiktok-api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "tiktokapi"
}
JSON
