Unofficial TikTok Profile API — Full Profile Data

GET/api/v1/profile

Fetch a user's profile by username.

ParameterDescription
usernameoptionalTikTok username, @handle, or profile URL. (Provide one of username / sec_uid / user_id.)
sec_uidoptionalThe account's secUid (alternative to username).
user_idoptionalThe account's numeric user id (alternative to username).
formatoptionalOmit for the full raw object (default). Use clean for a trimmed smart subset (name, country, stats, …).

Returns

By default, the complete raw userInfo object as TikTok exposes it (user, stats, statsV2, itemList, …). With format=clean, a trimmed object (username, country, followers, etc.).

Example Request

https://dev.omar-thing.site/api/v1/profile?username=tiktok&format=clean&key=YOUR_API_KEY

Example Response

{
  "data": {
    "itemList": [],
    "stats": {
      "diggCount": 0,
      "followerCount": 94400000,
      "followingCount": 3,
      "friendCount": 4,
      "heart": 458800000,
      "heartCount": 458800000,
      "videoCount": 1437
    },
    "statsV2": {
      "diggCount": "0",
      "followerCount": "94351351",
      "followingCount": "3",
      "friendCount": "4",
      "heart": "458782738",
      "heartCount": "458782738",
      "videoCount": "1437"
    },
    "user": {
      "UserStoryStatus": 1,
      "avatarLarger": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?x-expires=1781157600&x-signature=...",
      "avatarMedium": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?x-expires=1781157600&x-signature=...",
      "avatarThumb": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?x-expires=1781157600&x-signature=...",
      "bioLink": {
        "link": "linktr.ee/tiktok",
        "risk": 0
      },
      "canExpPlaylist": true,
      "commentSetting": 0,
      "commerceUserInfo": {
        "category": "Media & Entertainment",
        "categoryButton": false,
        "commerceUser": true
      },
      "createTime": 1425144149,
      "downloadSetting": 0,
      "duetSetting": 0,
      "eventList": [
        {
          "desc": "",
          "duration": "0",
          "enable_update": false,
          "has_subscribed": false,
          "id": "7647753210504937503",
          "is_paid_event": false,
          "is_promoting": false,
          "promote_video_count": 0,
          "start_time": "1781049600",
          "status": 0,
          "subscriber_count": "0",
          "ticket_amount": "0",
          "title": "Get Blue LIVE with Matt Damon",
          "type": 0,
          "under_review_desc": "",
          "write_acl": {
            "delete_block": null,
            "update_block": null
          }
        }
      ],
      "followingVisibility": 1,
      "ftc": false,
      "id": "107955",
      "isADVirtual": false,
      "isEmbedBanned": false,
      "isOrganization": 1,
      "language": "en",
      "nickNameModifyTime": 1638559600,
      "nickname": "TikTok",
      "nowInvitationCardUrl": "",
      "openFavorite": false,
      "privateAccount": false,
      "profileEmbedPermission": 1,
      "profileTab": {
        "showMusicTab": false,
        "showPlayListTab": true,
        "showQuestionTab": true
      },
      "recommendReason": "",
      "relation": 0,
      "roomId": "",
      "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
      "secret": false,
      "shortDramaCreator": {},
      "shortId": "",
      "signature": "One TikTok can make a big impact",
      "stitchSetting": 0,
      "suggestAccountBind": false,
      "ttSeller": false,
      "uniqueId": "tiktok",
      "uniqueIdModifyTime": 0,
      "verified": true
    }
  },
  "note": "Default (raw) response — TikTok's complete userInfo object. `itemList` (the user's videos) is omitted here for brevity. Add ?format=clean for a small, friendly subset.",
  "status": "success"
}
Sends a live request using your API key above.

More Profiles & Users endpoints