Love using Tiktok?
So do we!
This free API allows you to gain a deeper understanding of your Tiktok metrics, analytics and data.
It shows a Tiktok user's followers, people they are following, and other valuable post information.
Use Case: A Tiktok user who wants to keep track of his or her statistics to measure their account performance over time.
This API is equipped with many useful instance methods that allow a user to perform functions such as Logging-In, Getting User ID's, and Post ID's. This allows a user of this API to scrape valuable JSON data. This data can be used to create another application that leverages Tiktok's database.
An example of this type of third party application is SocialBlade. SocialBlade gathers data on the most popular platforms allowing influencers to track their engagement and analytics. Social blade currently does not have an integration for Tiktok.
This API solves that problem.
Make sure you have the latest version of NPM installed
run this command in your terminal:
npm i tiktok-api
Click here to see how to create an instance of the API.
This endpoint allows you to log in to Tiktok with your username & password.
| Path Parameter | Description |
|---|---|
| {loginWithUsername} | The username you are using to sign in. |
| Query string paramater | Required/Optional | Description | Type |
|---|---|---|---|
| username | Required | The username you are using to sign in. | String |
| password | Required | The password for your account. | String |
api.loginWithUsername('<username>', '<password>')
.then(res => console.log(res.data))
.catch(console.log){
"avatar_url": "www.tiktok/username/profile_img,
"birthday": "December 1, 1990",
"can_be_found_by_phone": 562-323-9876,
"email": "[email protected]",
"mobile": "562-323-3456",
"new_user": 1
}The following table describes each item in the response.
| Response Item | Description | Data type |
|---|---|---|
| avatar_url | The users profile image URL. | String |
| birthday | The users birthday. | String |
| can_be_found_by_phone | The users phone number. | Integer |
| The users email adress. | String | |
| gender | The users gender. | Integer |
| new_user | Indicates if a user is new | Integer |
{
"captcha": "captchaanswer",
"description": "Account not found",
"error-code": 404,
}This endpoint allows you get a users ID.
| Path Parameter | Description |
|---|---|
| {id} | The id of the user you are searching for. |
api.getUser('<user_id>')
.then(res => console.log(res.data.user))
.catch(console.log);{
"aweme_count": 22,
"favoriting_count": 4,
"follower_count": 300,
"following_count": 20,
"total_favorited": 8,
"follow_status": 1
}The following table describes each item in the response.
| Response Item | Description | Data type |
|---|---|---|
| aweme_count | The number of videos the user has uploaded. | Integer |
| favoriting_count | The number of videos the user has liked | Integer |
| follower_count | The amount of followers the user has. | Integer |
| following_count | The amount of users this users follows. | Integer |
| total_favorited | The total number of likes this user has received. | Integer |
| follow_status | Indicates if you follow this user,1 if true 0 if false. | Integer |
This endpoint allows you to retrieve a specific post by ID.
| Path Parameter | Description |
|---|---|
| {id} | The id of the post you are searching for. |
api.getPost('<user_id>')
.then(res => console.log(res.data.aweme_detail))
.catch(console.log);{
"author_user_id": 12343,
"aweme_id": 3245,
"aweme_type": 1,
"create_time": 2019-09-12T20:52:25+00:00,
"music": "Back in Black - ACDC",
"prevent_download": False,
"rate": 12
}The following table describes each item in the response.
| Response Item | Description | Data type |
|---|---|---|
| author_user_id | The ID of the post author | String |
| aweme_id | The ID of the post | String |
| aweme_type | The type of post. | Integer |
| create_time | The time the post was created (in seconds). | Integer |
| music | The music used in this post. | MusicTrack |
| prevent_download | True if user cannot download the video. | Boolean |
| rate | Age rating for the video. | Integer |
This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by TikTok or any of its affiliates or subsidiaries.
This is an independent and unofficial API. Use at your own risk.
Before: Every software engineering application is built differently, and I find it an interesting and valuable experience to reverse engineer and discover how applications are implemented.
After: I reverse engineer applications to understand how they work. Every software application is unique, and it is a joy to discover the exact ways in how they differ from each other.