Get Profile Get public profile information for a TikTok user.
Endpoint Query Parameters TikTok username (without @ symbol)
Example Request curl -X GET "https://rocks.rive.wtf/api/tiktok/profile?username=charlidamelio" \ -H "Authorization: Bearer YOUR_API_KEY"
Response Example { "status" : 200 , "success" : true , "data" : { "success" : true , "data" : { "user" : { "id" : "5831967" , "uniqueId" : "charlidamelio" , "nickname" : "charli d'amelio" , "avatarThumb" : "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/7310052907548688430~tplv-tiktokx-cropcenter:100:100.jpeg..." , "avatarMedium" : "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/7310052907548688430~tplv-tiktokx-cropcenter:720:720.jpeg..." , "avatarLarger" : "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/7310052907548688430~tplv-tiktokx-cropcenter:1080:1080.jpeg..." , "signature" : "" , "verified" : true , "secUid" : "MS4wLjABAAAA-VASjiXTh7wDDyXvjk10VFhMWUAoxr8bgfO1kAL1-9s" , "secret" : false , "privateAccount" : false , "createTime" : 1447505838 , "language" : "en" , "canExpPlaylist" : true , "isEmbedBanned" : false , "profileEmbedPermission" : 1 }, "stats" : { "followerCount" : 155900000 , "followingCount" : 1302 , "heartCount" : 0 , "heart" : 11900000000 , "videoCount" : 2893 , "diggCount" : 0 , "friendCount" : 1147 }, "shareMeta" : { "title" : "charli d'amelio on TikTok" , "desc" : "@charlidamelio 155900000 Followers, 1302 Following, 0 Likes - Watch awesome short videos created by charli d'amelio" }, "region" : null , "social_links" : [] } } }
Response Fields Whether the request was successful
Container for profile data User profile information
id - TikTok user IDuniqueId - Username/handlenickname - Display nameavatarThumb - Small avatar (100x100)avatarMedium - Medium avatar (720x720)avatarLarger - Large avatar (1080x1080)signature - User bio/descriptionverified - Verification statussecUid - Secure user IDsecret - Whether account has secret videosprivateAccount - Whether account is privatecreateTime - Account creation timestamp (Unix)language - Profile language code Profile statistics
followerCount - Number of followersfollowingCount - Number of accounts followingheart - Total likes across all videosheartCount - Alternative heart count field (may be 0)videoCount - Total number of videos posteddiggCount - Number of videos liked by userfriendCount - Number of friends Metadata for sharing
title - Share titledesc - Share description Array of linked social media accounts
Only public TikTok profiles can be accessed through this API. Private or restricted profiles will return limited information. The heart field represents the total number of likes across all videos.
Three avatar sizes are available: avatarThumb (100x100), avatarMedium (720x720), and avatarLarger (1080x1080). Choose the appropriate size for your use case.
Use Cases
Social Analytics Track TikTok influencer metrics and growth
Profile Verification Verify TikTok creators in your platform
Content Discovery Build TikTok profile search tools
Bot Integration Display TikTok stats in Discord/Telegram bots
Avatar Image Sizes TikTok provides three avatar sizes in the response:
Field Size Best For avatarThumb100x100 Small icons, lists avatarMedium720x720 Profile cards, embeds avatarLarger1080x1080 Full-size displays, downloads
Choose the appropriate avatar size based on your display requirements to optimize bandwidth and loading times. 