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>/user/: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>/video/:userHandle/:videoId

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": ""
}

Last updated