TikTok

List of TikTok APIs

baseURL: wv2h4to5qa.execute-api.us-east-2.amazonaws.com/dev/tiktok

To obtain x-api-key please contact the team. You can find more information at the "Connect With Us" section

Authentication

All requests require a valid API key to be included in the x-api-key header.

Fetch TikTok User by UserHandle

GET https://<baseURL>/video/:userHandle

Fetches the details of a TikTok user by their user handle

If the user exists in the database, it returns the existing user data. Otherwise, it fetches the user data from TikTok and saves it.

Request Parameters

Name
Type
Description

userHandle*

string

Provide the unique TikTok User Handle of the TikTok user 

{
    "isError": false,
    "data": {
        "user": {
            "id": "yourstudyspace",
            "nickname": "paula",
            "id_dup": "7019574569066644486",
            "secUid": "MS4wLjABAAAAO2Ynh8-sOeMiGLTjHAHW_ByqOYcyyykPtPOaWNcsj18U0vhtRXHVghJHFN5PnYmJ",
            "profileBio": "motivation, life & mental health\nbe afraid, do it anyway.\nGO VEGAN.🌱\n📕💌🫀",
            "profilePictureUrl": "https://p77-sign-va-lite.tiktokcdn.com/tos-maliva-avt-0068/7310267379203145733~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=78015&refresh_token=82f4051ffd9fa05570fd076b211c9384&x-expires=1725051600&x-signature=EPdCBfYppZkVwLOOkFD0cASX%2F6Y%3D&shp=a5d48078&shcp=81f88b70",
            "isVerified": false,
            "isPrivateAccount": false,
            "createdAt": "2024-08-28T16:52:08.362Z",
            "updatedAt": "2024-08-28T21:51:27.064Z"
        },
        "stats": {
            "diggCount": 0,
            "followerCount": 56200,
            "followingCount": 591,
            "friendCount": 50,
            "heartCount": 1500000,
            "heart": 1500000,
            "videoCount": 204
        }
    },
    "message": ""
}

Fetch TikTok Video by Video Id and User Handle

GET https://<baseURL>/videos/:userHandle

Fetches details of a TikTok video given video id and user handle of video's author. These parameters can be easily found in a typical TikTok video link.

Request Parameters

Name
Type
Description

userHandle*

string

Provide the unique TikTok User Handle of the video's author

videoId*

string

Provide the id of the video

{
    "isError": false,
    "data": {
        "id": "7269439155992562976",
        "description": "I‘ve already said this and I‘ll say it again: even if everything feels too overwhelming to go on - look at your statistics: YOU‘VE SURVIVED 100% OF YOUR WORST DAYS 🫶🏻 #yourstudyspace #studyaesthetic #lifequote #studentssupportingstudents #school #studyhacks #studyingaesthetic #inspirational #uni #studentlife #remindertomyself #motivational #inspirationalquotes #studytok #selflove #trendingsound #motivationalquotes #fypシ゚viral #foryou ",
        "createTime": "2023-08-20T16:16:45.000Z",
        "duration": 14,
        "music": {
            "id": "7251477791844502278",
            "title": "original sound - James Lacaba",
            "authorName": "James Lacaba",
            "album": null,
            "duration": 14,
            "original": false,
            "private": false,
            "createdAt": "2024-08-28T17:12:07.017Z",
            "updatedAt": "2024-08-28T17:12:07.017Z"
        },
        "stats": {
            "diggCount": 967100,
            "collectCount": 184503,
            "commentCount": 2119,
            "playCount": 6500000,
            "repostCount": 0,
            "shareCount": 55200
        },
        "author": {
            "id": "yourstudyspace",
            "nickname": "paula",
            "id_dup": "7019574569066644486",
            "secUid": "MS4wLjABAAAAO2Ynh8-sOeMiGLTjHAHW_ByqOYcyyykPtPOaWNcsj18U0vhtRXHVghJHFN5PnYmJ",
            "profileBio": "motivation, life & mental health\nbe afraid, do it anyway.\nGO VEGAN.🌱\n📕💌🫀",
            "profilePictureUrl": "https://p77-sign-va-lite.tiktokcdn.com/tos-maliva-avt-0068/7310267379203145733~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=78015&refresh_token=82f4051ffd9fa05570fd076b211c9384&x-expires=1725051600&x-signature=EPdCBfYppZkVwLOOkFD0cASX%2F6Y%3D&shp=a5d48078&shcp=81f88b70",
            "isVerified": false,
            "isPrivateAccount": false,
            "createdAt": "2024-08-28T16:52:08.362Z",
            "updatedAt": "2024-08-28T21:51:27.064Z"
        },
        "authorStats": {
            "diggCount": 0,
            "followerCount": 56200,
            "followingCount": 591,
            "friendCount": 50,
            "heartCount": 1500000,
            "heart": 1500000,
            "videoCount": 204
        }
    },
    "message": ""
}

Fetch TikTok User by UserHandle

GET https://<baseURL>/video/:userHandle

Fetches the details of a TikTok user by their user handle

If the user exists in the database, it returns the existing user data. Otherwise, it fetches the user data from TikTok and saves it.

Request Parameters

Name
Type
Description

userHandle*

string

Provide the unique TikTok User Handle of the TikTok user

Fetch TikTok Followers by UserHandle

GET https://<baseURL>/followers/:userHandle

<Description of the endpoint>

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Description

name

string

Name of the user

age

number

Age of the user

Response

{
  "id": 1,
  "name": "John",
  "age": 30
}

Fetch TikTok Followings by UserHandle

GET https://<baseURL>/followings/:userHandle

<Description of the endpoint>

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Body

Name
Type
Description

name

string

Name of the user

age

number

Age of the user

Response

{
  "id": 1,
  "name": "John",
  "age": 30
}

PreviousXNextTelegram

Last updated