# TikTokApiSdk

**Repository Path**: yuezhai/tik-tok-api-sdk

## Basic Information

- **Project Name**: TikTokApiSdk
- **Description**: 联系微信（1764328791）、抖音API、抖音数据、抖音直播数据、抖音直播Api、抖音视频Api、抖音爬虫、抖音去水印、抖音视频下载、抖音视频解析、抖音直播监控、抖音数据采集
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-11-03
- **Last Updated**: 2024-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# TikTok非官方 Api Python SDK
TikTok非官方ApiSDK
主要功能模块：视频、用户、标签

如果你想直接使用TikTok在线接口，请查看：
 [ApiDoc](https://github.com/Video-Hub/tiktok-api)


## Table of Contents
- [TikTok非官方 Api Python SDK](#tiktok非官方-api-python-sdk)
  - [Table of Contents](#table-of-contents)
  - [Getting Started](#getting-started)
    - [Installing](#installing)
    - [Common Issues](#common-issues)
  - [Quick Start Guide](#quick-start-guide)
  - [Detailed Documentation](#detailed-documentation)
      - [Common Parameters](#common-parameters)
      - [The TikTok class](#the-tiktok-class)
        - [The trending Method](#the-trending-method)
        - [The get_Video_By_TikTok Method](#the-get_video_by_tiktok-method)
        - [The bySound Method](#the-bysound-method)
        - [The getUserObject Method](#the-getuserobject-method)
        - [The getTikTokById Method](#the-gettiktokbyid-method)
        - [The getTikTokByUrl Method](#the-gettiktokbyurl-method)
        - [The getUser Method](#the-getuser-method)
        - [The getMusicObject Method](#the-getmusicobject-method)
        - [The getHashtagObject Method](#the-gethashtagobject-method)
        - [The byUsername Method](#the-byusername-method)
        - [The byHashtag Method](#the-byhashtag-method)
        - [The discoverMusic Method](#the-discovermusic-method)
        - [The discoverHashtags Method](#the-discoverhashtags-method)
        - [The userLiked Method](#the-userliked-method)
    - [The userLikedbyUsername Method](#the-userlikedbyusername-method)
        - [The getSuggestedUsersbyID Method](#the-getsuggestedusersbyid-method)
        - [The getSuggestedUsersbyIDCrawler Method](#the-getsuggestedusersbyidcrawler-method)
        - [The getSuggestedHashtagsbyID Method](#the-getsuggestedhashtagsbyid-method)
        - [The getSuggestedHashtagsbyIDCrawler Method](#the-getsuggestedhashtagsbyidcrawler-method)
        - [The getSuggestedMusicbyID Method](#the-getsuggestedmusicbyid-method)
        - [The getSuggestedMusicIDCrawler Method](#the-getsuggestedmusicidcrawler-method)
        - [The get_Video_By_DownloadURL Method](#the-get_video_by_downloadurl-method)
        - [The get_Video_By_Url Method](#the-get_video_by_url-method)
        - [The get_Video_No_Watermark_Faster Method](#the-get_video_no_watermark_faster-method)
        - [The search_for_users Method](#the-search_for_users-method)
        - [The search_for_music Method](#the-search_for_music-method)
        - [The search_for_hashtags Method](#the-search_for_hashtags-method)
        - [The discover_type Method](#the-discover_type-method)
        - [The get_Video_No_Watermark_ID Method](#the-get_video_no_watermark_id-method)
        - [The get_Video_No_Watermark Method](#the-get_video_no_watermark-method)
      - [The TikTokUser class](#the-tiktokuser-class)
        - [The get_Video_No_Watermark Method](#the-get_video_no_watermark-method-1)
  - [Built With](#built-with)
  - [License](#license)

## Getting Started

To get started using this api follow the instructions below.

### Installing

If you run into an issue please check the closed issues on the github. You're most likely not the first person to experience this issue. If nothing works feel free to open an issue.

```
pip install TikTokApi
python -m playwright install
```

If you're on MacOS you may need to install [XCode Developer Tools](https://webkit.org/build-tools/)


### 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 object has no attribute verifyFp](https://github.com/davidteather/TikTok-Api/issues/237) There's so many issues by this error please search (open and closed) issues before posting
* [Browser closed unexpectedly](https://github.com/davidteather/TikTok-Api/issues/95)
* [BadStatusLine](https://github.com/davidteather/TikTok-Api/issues/88)

## Quick Start Guide

Here's a quick bit of code to get the most recent trending on TikTok. There's more examples in the examples directory.

```
from TikTokApi import TikTokApi
api = TikTokApi.get_instance()

results = 10

trending = api.trending(count=results)

for tiktok in trending:
    # Prints the id of the tiktok
    print(tiktok['id'])

print(len(trending))
```

To run the example scripts from the repository root, make sure you use the
module form of python the interpreter

```
python -m examples.getTrending
```

[Here's](https://gist.github.com/davidteather/7c30780bbc30772ba11ec9e0b909e99d) an example of what a tiktok dictionary looks like.

## Detailed Documentation

**Note**: This documentation is called detailed, which it is, but it may be out of date. And if you see something wrong or want to improve the documentation feel free to open a PR with the fixes.

#### Common Parameters

* username - the username of a user you want to find
* secUid - the secUid of the user (you can find in the responses)
* userId / id - The id of the user
* proxy - the proxy address of your proxy
* language - the 2 letter code for your language (this is included in the requests by default to TikTok, but it doesn't seem to do much for me at least)
* language - Ex: en (doesn't seem to change data)
* region - Ex: US (doesn't seem to change data)

#### The TikTok class

```
TikTokApi(self, debug=False, request_delay=None, executablePath=None)
```

debug - Enable this if you need some more output.

request_delay - The time to wait in seconds before sending a request.

executablePath - The path to your chromedriver if you don't want global install of chromedriver.

##### The trending Method

```
api.trending(self, count=30, referrer="https://www.tiktok.com/@ondymikula/video/6756762109670477061", language='en', proxy=None)
```

count - this is how many trending Tiktoks you want to be returned.

Trending returns an array of dictionaries. Example structure [here](https://www.tiktok.com/@ondymikula/video/6756762109670477061)

##### The get_Video_By_TikTok Method

```
api.get_Video_By_TikTok(data, language='en', proxy=None)
```

data - The tiktok dictionary returned from the API. Will return bytes.


##### The bySound Method

This method returns an array of tiktoks based on a sound id.
```
def bySound(self, id, count=30, language='en', proxy=None)
```

id - the sound's id (you can get this from other methods)


##### The getUserObject Method

This method returns a user object, primarily used for other methods within the package.
```
def getUserObject(self, username, language='en', proxy=None)
```

##### The getTikTokById Method

This object returns a TikTok object when given the TikTok ID.
```
def getTikTokById(self, id, language='en', proxy=None)
```

##### The getTikTokByUrl Method

This does the same as the getTikTokById method, but it extracts the id out of the url.
```
def getTikTokByUrl(self, url, language='en', proxy=None)
```

##### The getUser Method

This method returns a user object, including all profile data about the user.
```
def getUser(self, username, language='en', proxy=None)
```

username - the unique username of the person you want to get an object for.

##### The getMusicObject Method

This method returns a music object, primarily used for other methods within the package.

```
def getMusicObject(self, id, language='en', proxy=None)
```

id - the ID of the music.

##### The getHashtagObject Method

This method returns a hashtag (challenge) object, primarily used for other methods within the package.

```
def getHashtagObject(self, hashtag, language='en', proxy=None)
```

hashtag - the hashtag or challenge name

##### The byUsername Method

This method returns an array of tiktoks by a username

```
def byUsername(self, username, count=30, language='en', proxy=None)
```

##### The byHashtag Method

This method returns an array of TikToks by a given hashtag or challenge (without the #)

```
def byHashtag(self, hashtag, count=30, language='en', proxy=None)
```

hashtag - a given hashtag or challenge without the #

##### The discoverMusic Method

Returns trending music shown on the side at tiktok's trending page on desktop

```
def discoverMusic(self, language='en', proxy=None)
```

##### The discoverHashtags Method

Returns trending hashtags (challenges) shown on the side at tiktok's trending page on desktop

```
def discoverHashtags(self, language='en', proxy=None)
```

##### The userLiked Method

Returns a list of a given user's liked TikToks. Returns a length of 0 if private list.
```
userLiked(self, userID, secUID, count=30, language='en', region='US', proxy=None)
```

### The userLikedbyUsername Method

Returns a list of a given user's liked TikToks. Returns a length of 0 if private list.
```
userLikedbyUsername(self, username, count=30, proxy=None, language='en', region='US')
```

##### The getSuggestedUsersbyID Method

This method gets suggested users for a given userid.
```
getSuggestedUsersbyID(self, count=30, userId='6745191554350760966', language='en', proxy=None)
```

##### The getSuggestedUsersbyIDCrawler Method

This method gets users across a variety of userids.
```
getSuggestedUsersbyIDCrawler(self, count=30, startingId='6745191554350760966', language='en', proxy=None)
```

##### The getSuggestedHashtagsbyID Method

This method gets related hashtags given a userid.
```
getSuggestedHashtagsbyID(self, count=30, userId='6745191554350760966', language='en', proxy=None)
```

##### The getSuggestedHashtagsbyIDCrawler Method

This method crawls across multiple user's profile using the user crawler method to generate hashtags.
```
getSuggestedHashtagsbyIDCrawler(self, count=30, startingId='6745191554350760966', language='en', proxy=None)
```

##### The getSuggestedMusicbyID Method

This method gets suggested music given a userId
```
getSuggestedMusicbyID(self, count=30, userId='6745191554350760966', language='en', proxy=None)
```

##### The getSuggestedMusicIDCrawler Method

This method crawls across multiple user's profile using the user crawler method to generate music objects.
```
getSuggestedMusicIDCrawler(self, count=30, startingId='6745191554350760966', language='en', proxy=None)
```

##### The get_Video_By_DownloadURL Method

```
api.get_Video_By_DownloadURL(url, language='en', proxy=None)
```

url - The download url that's found in the TikTok dictionary. TikTok['video']['downloadAddr']


##### The get_Video_By_Url Method

```
api.get_Video_By_Url(video_url, return_bytes=0)
```

video_url - The video you want to get url.

return_bytes - The default value is 0, when it is set to 1 the function instead returns the bytes from the video rather than just the direct url.

##### The get_Video_No_Watermark_Faster Method

```
api.get_Video_No_Watermark(video_url, return_bytes=0, language='en', proxy=None)
```

video_url - The video you want to get url.

return_bytes - The default value is 0, when it is set to 1 the function instead returns the bytes from the video rather than just the direct url.

If you request without bytes you will need to make a call to the URL it responds yourself to get bytes.
```
url = api.get_Video_No_Watermark_ID('6829267836783971589', return_bytes=0)

import requests
video_bytes = requests.get(url, headers={"User-Agent": "okhttp"}).content
```

##### The search_for_users Method

```
def search_for_users(self, search_term, count=28, **kwargs)
```

Searches for users given a search term.

##### The search_for_music Method

```
def search_for_music(self, search_term, count=28, **kwargs)
```

Searches for music given a search term

##### The search_for_hashtags Method

```
def search_for_hashtags(self, search_term, count=28, **kwargs)
```

Searches for hashtags given a search term.

##### The discover_type Method

```
discover_type(self, search_term, prefix, count=28, **kwargs)
```

You can use this method if you really want, but just use the 3 above it.

##### The get_Video_No_Watermark_ID Method

```
api.get_Video_No_Watermark_ID(self, video_id, return_bytes=1, proxy=None)
```

video_id - The video id you want to get.

return_bytes - The default value is 0, when it is set to 1 the function instead returns the bytes from the video rather than just the direct url.


If you request without bytes you will need to make a call to the URL it responds yourself to get bytes.
```
url = api.get_Video_No_Watermark_ID('6829267836783971589', return_bytes=0)

import requests
video_bytes = requests.get(url, headers={"User-Agent": "okhttp"}).content
```

##### The get_Video_No_Watermark Method
```
api.get_Video_No_Watermark(self, video_url, return_bytes=0, proxy=None)
```

This endpoint returns a url that is able to be opened in any browser, but sacrifices speed for this convenience. Any old request library can return the bytes if you decide to return a url.

video_url - the url of the video you wish to download

return_bytes - if you want to return bytes or a url

#### The TikTokUser class

```
user = TikTokUser(self, user_cookie, debug=False)
```
user_cookie - The cookie of the logged in user. To get this string log into the desktop site of TikTok and go to the javascript console and type in document.cookie and copy that string and pass it in here.


debug - Enable this if you need some more output.


Will be denoted by user for the methods below

##### The get_Video_No_Watermark Method
```
user.get_insights(videoID, username=None)
```

This endpoint returns a the insights/analytics for a specific TikTok video.

videoID - The id of the TikTok

username - You don't need to provide this, but it's possible TikTok compares the refer header in the future so it's more robust to do this.


## Built With

* [Python 3.7](https://www.python.org/) - The web framework used

## License

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
  
![](https://visitor-badge.laobi.icu/badge?page_id=Video-Hub.TikTokApiSdk)