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

200: OK

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

400: ERROR

{"message": "TikTok userHandle is required"}
or
{"message": "Unable to find a TikTok account with specified userHandle"}

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

200: OK

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

400: ERROR

{"message": "TikTok userHandle is required"}
or
{"message": "TikTok videoId is required"}
or
{"message": "Unable to find a TikTok video with specified videoId and userHandle"}

Camp Auth APIsCamp APIs