<h1 align="center" style="font-size: 3rem;">
TikTokPy
</h1>
<p align="center">
<em>Tooling that <b>automates</b> your social media interactions to “farm” Likes and Followers on TikTok</em></p>
<p align="center">
<a href="https://github.com/sudoguy/tiktokpy/actions/workflows/test_and_publish.yml">
<img src="https://github.com/sudoguy/tiktokpy/actions/workflows/test_and_publish.yml/badge.svg" alt="Build Status">
</a>
<a href="https://pypi.org/project/tiktokpy/">
<img src="https://badge.fury.io/py/tiktokpy.svg" alt="Package version">
</a>
</p>
---
## Quickstart.py
```python
import asyncio
from tiktokpy import TikTokPy
async def main():
async with TikTokPy() as bot:
# Do you want to get trending videos? You can!
trending_items = await bot.trending(amount=5)
for item in trending_items:
# ❤️ you can like videos
await bot.like(item)
# or unlike them
await bot.unlike(item)
# or follow users
await bot.follow(item.author.username)
# as and unfollow
await bot.unfollow(item.author.username)
# 😏 getting user's feed
user_feed_items = await bot.user_feed(username="tiktok", amount=5)
for item in user_feed_items:
# 🎧 get music title, cover, link, author name..
print("Music title: ", item.music.title)
# #️⃣ print all tag's title of video
print([tag.title for tag in item.challenges])
# 📈 check all video stats
print("Comments: ", item.stats.comments)
print("Plays: ", item.stats.plays)
print("Shares: ", item.stats.shares)
print("Likes: ", item.stats.likes)
# and many other things 😉
asyncio.run(main())
```
## Installation
Install with pip:
```shell
pip install tiktokpy
```
Install browser by playwright
```shell
playwright install firefox
```
## Run
To create your cookies and settings.toml file simply run
```shell
python quicklogin.py
```
and then after you login run
```shell
python quickstart.py
```
Raw data
{
"_id": null,
"home_page": "https://github.com/sudoguy/tiktokpy/",
"name": "tiktokpy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "tiktok,bot,api,wrapper,tiktokbot,tiktokpy,webapi,marketing",
"author": "Evgeny Kemerov",
"author_email": "eskemerov@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/74/51/e5eb6f6fe0d8838bd74191fd9fa76cf953f070ea08e34a946013c18d1251/tiktokpy-0.9.4.tar.gz",
"platform": null,
"description": "<h1 align=\"center\" style=\"font-size: 3rem;\">\nTikTokPy\n</h1>\n<p align=\"center\">\n <em>Tooling that <b>automates</b> your social media interactions to \u201cfarm\u201d Likes and Followers on TikTok</em></p>\n\n\n<p align=\"center\">\n<a href=\"https://github.com/sudoguy/tiktokpy/actions/workflows/test_and_publish.yml\">\n <img src=\"https://github.com/sudoguy/tiktokpy/actions/workflows/test_and_publish.yml/badge.svg\" alt=\"Build Status\">\n</a>\n<a href=\"https://pypi.org/project/tiktokpy/\">\n <img src=\"https://badge.fury.io/py/tiktokpy.svg\" alt=\"Package version\">\n</a>\n</p>\n\n---\n\n## Quickstart.py\n\n```python\nimport asyncio\nfrom tiktokpy import TikTokPy\n\n\nasync def main():\n async with TikTokPy() as bot:\n # Do you want to get trending videos? You can!\n trending_items = await bot.trending(amount=5)\n\n for item in trending_items:\n # \u2764\ufe0f you can like videos\n await bot.like(item)\n # or unlike them\n await bot.unlike(item)\n # or follow users\n await bot.follow(item.author.username)\n # as and unfollow\n await bot.unfollow(item.author.username)\n\n # \ud83d\ude0f getting user's feed\n user_feed_items = await bot.user_feed(username=\"tiktok\", amount=5)\n\n for item in user_feed_items:\n # \ud83c\udfa7 get music title, cover, link, author name..\n print(\"Music title: \", item.music.title)\n # #\ufe0f\u20e3 print all tag's title of video\n print([tag.title for tag in item.challenges])\n # \ud83d\udcc8 check all video stats\n print(\"Comments: \", item.stats.comments)\n print(\"Plays: \", item.stats.plays)\n print(\"Shares: \", item.stats.shares)\n print(\"Likes: \", item.stats.likes)\n\n # and many other things \ud83d\ude09\n\n\nasyncio.run(main())\n```\n\n## Installation\n\nInstall with pip:\n\n```shell\npip install tiktokpy\n```\n\nInstall browser by playwright\n\n```shell\nplaywright install firefox\n```\n\n## Run\n\nTo create your cookies and settings.toml file simply run\n\n```shell\npython quicklogin.py\n```\nand then after you login run\n\n```shell\npython quickstart.py\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tool for automated TikTok interactions.",
"version": "0.9.4",
"project_urls": {
"Homepage": "https://github.com/sudoguy/tiktokpy/",
"Repository": "https://github.com/sudoguy/tiktokpy/"
},
"split_keywords": [
"tiktok",
"bot",
"api",
"wrapper",
"tiktokbot",
"tiktokpy",
"webapi",
"marketing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1a88e8858e69ddf34a02c0f6da41462569008c939251720c89dc610fc4ac48c4",
"md5": "b1970cba596613970015cccddb0a82d8",
"sha256": "f220b323f29e649ca16d15ad63aa62ca9794683310859a650488a5e506cc80e0"
},
"downloads": -1,
"filename": "tiktokpy-0.9.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b1970cba596613970015cccddb0a82d8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 15702,
"upload_time": "2023-09-06T15:48:00",
"upload_time_iso_8601": "2023-09-06T15:48:00.453427Z",
"url": "https://files.pythonhosted.org/packages/1a/88/e8858e69ddf34a02c0f6da41462569008c939251720c89dc610fc4ac48c4/tiktokpy-0.9.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7451e5eb6f6fe0d8838bd74191fd9fa76cf953f070ea08e34a946013c18d1251",
"md5": "b3c72166593e1488025d5db3898771e0",
"sha256": "7c9c94d0ff1b1977b2399d3faecfd559c5674f6e094d44e8597ec0c34b3c8506"
},
"downloads": -1,
"filename": "tiktokpy-0.9.4.tar.gz",
"has_sig": false,
"md5_digest": "b3c72166593e1488025d5db3898771e0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 12036,
"upload_time": "2023-09-06T15:48:02",
"upload_time_iso_8601": "2023-09-06T15:48:02.143459Z",
"url": "https://files.pythonhosted.org/packages/74/51/e5eb6f6fe0d8838bd74191fd9fa76cf953f070ea08e34a946013c18d1251/tiktokpy-0.9.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-06 15:48:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sudoguy",
"github_project": "tiktokpy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tiktokpy"
}
JSON
