Unofficial TikTok Profile API — Full Profile Data
GET/api/v1/profile
Fetch a user's profile by username.
| Parameter | Description | |
|---|---|---|
username | optional | TikTok username, @handle, or profile URL. (Provide one of username / sec_uid / user_id.) |
sec_uid | optional | The account's secUid (alternative to username). |
user_id | optional | The account's numeric user id (alternative to username). |
format | optional | Omit 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
- Unofficial TikTok Analytics API — Audience insights for a public creator account: follower breakdown by country, age and gender, an overview for a date range, and growth milestones. Pass
videofor a single video's stats. - Unofficial TikTok Followers API — List an account's followers.
- Unofficial TikTok Following API — List the accounts a user follows.
- Unofficial TikTok Current Region API — Get an account's current region (country) by its numeric user id.