TikTok API

The TikTok API lets you look up user profiles, list videos, read comments and replies, search videos and users, explore hashtags, and traverse the social graph (followers / followings). Eleven endpoints, all at 1 credit per request.

Endpoints

Authentication

Every successful response includes credit tracking fields: credits_used, credits_remaining, and response_time (ms).

Getting a sec_user_id

Most endpoints require a sec_user_id instead of a username. Call the Profile endpoint first with a username, then use data.user.sec_uid for subsequent requests.

User Profile

POST https://api.scavio.dev
/api/v1/tiktok/profile

Get a TikTok user profile. Pass either username or sec_user_id.

Request Body

Example Request

curl -X POST 'https://api.scavio.dev
/api/v1/tiktok/profile' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"username": "tiktok"}'

Response Fields (data.user)

Example Response

{
  "data": {
    "user": {
      "unique_id": "tiktok",
      "nickname": "TikTok",
      "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
      "uid": "107955",
      "signature": "One TikTok can make a big impact",
      "bio_url": "linktr.ee/tiktok",
      "follower_count": 94015018,
      "following_count": 1,
      "aweme_count": 1510,
      "total_favorited": 457945663
    }
  },
  "response_time": 1245,
  "credits_used": 1,
  "credits_remaining": 11753
}

User Posts

POST https://api.scavio.dev
/api/v1/tiktok/user/posts

List a user's videos. Requires sec_user_id (get it from the profile endpoint).

Request Body

Pagination

Use data.max_cursor as cursor in the next request. Stop when data.has_more is 0.

Video Fields (data.aweme_list[])

Video Detail

POST https://api.scavio.dev
/api/v1/tiktok/video

Get full details for a single video.

Request Body

Example Request

curl -X POST 'https://api.scavio.dev
/api/v1/tiktok/video' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"video_id": "7350810998023949599"}'

Additional Fields (data.aweme_detail)

Includes all video fields listed above, plus:

Example Response

{
  "data": {
    "aweme_detail": {
      "aweme_id": "7350810998023949599",
      "desc": "im so sick of being tired im so tired of being sick",
      "create_time": 1711494099,
      "statistics": {
        "digg_count": 2002382,
        "comment_count": 8119,
        "play_count": 12171757,
        "share_count": 274978,
        "collect_count": 211332
      }
    }
  },
  "response_time": 1605,
  "credits_used": 1,
  "credits_remaining": 11752
}

Video Comments

POST https://api.scavio.dev
/api/v1/tiktok/video/comments

Get comments on a video.

Request Body

Pagination

Use data.cursor as the next cursor. Stop when data.has_more is 0.

Comment Fields (data.comments[])

Comment Replies

POST https://api.scavio.dev
/api/v1/tiktok/video/comments/replies

Get replies to a specific comment.

Request Body

Pagination

Same as comments: use data.cursor, stop when data.has_more is 0. Each reply has the same fields as a comment object.

Search Videos

POST https://api.scavio.dev
/api/v1/tiktok/search/videos

Search TikTok videos by keyword.

Request Body

Example Request

curl -X POST 'https://api.scavio.dev
/api/v1/tiktok/search/videos' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"keyword": "cooking recipe", "count": 10, "publish_time": "7"}'

Pagination

Use data.cursor as the next cursor. Stop when data.has_more is 0. Each item in data.aweme_list has the same structure as a video detail.

Search Users

POST https://api.scavio.dev
/api/v1/tiktok/search/users

Search TikTok users by keyword.

Request Body

Response Fields (data.user_list[].user_info)

Hashtag Info

POST https://api.scavio.dev
/api/v1/tiktok/hashtag

Get hashtag details and stats. Pass either hashtag_name or hashtag_id.

Request Body

Response Fields

Example Response

{
  "data": {
    "challengeInfo": {
      "challenge": {
        "id": "229207",
        "title": "fyp",
        "desc": "",
        "stats": {
          "videoCount": 0,
          "viewCount": 118798000000000
        }
      }
    }
  },
  "response_time": 892,
  "credits_used": 1,
  "credits_remaining": 11751
}

Hashtag Videos

POST https://api.scavio.dev
/api/v1/tiktok/hashtag/videos

List videos for a hashtag. Requires hashtag_id (get it from the hashtag info endpoint).

Request Body

Pagination

Use data.cursor as the next cursor. Stop when data.has_more is 0. Response contains data.aweme_list[] with the same video structure as search and user posts.

User Followers

POST https://api.scavio.dev
/api/v1/tiktok/user/followers

Get a user's follower list.

Request Body

Pagination

Pass both page_token and min_time from the previous response. Stop when data.has_more is false.

Follower Fields (data.followers[])

User Followings

POST https://api.scavio.dev
/api/v1/tiktok/user/followings

Get accounts a user follows. Same request shape and parameters as followers. Response uses data.followings[] instead of data.followers[].

Pagination Reference

Notes

• All create_time fields are Unix timestamps in seconds. Multiply by 1000 for JavaScript Date.
• Avatar and image fields return an object with a url_list array. Use .url_list[0] for the URL.
• See Errors for 401, 429, and 502 handling.