Type Value: TIKTOK_USER
Status: PRODUCTION
A TIKTOK_USER
link type represents a TikTok creator’s profile. Along with the common preview attributes (title
, description
, image
), TIKTOK_USER
links provide enriched user information—like follower and like counts, display names, and verification status—helping you showcase creator profiles with greater depth.
What It Includes
When type
is TIKTOK_USER
, the response includes a tiktokUser
object with fields such as:
- username & name: The user’s handle and display name.
- avatar: Responsive images for the user’s profile picture.
- bio: A short biography describing the creator’s background or style.
- followersCount, followingCount, likesCount: Metrics that highlight the creator’s popularity and engagement.
- visibility: Indicates if the account is
PUBLIC
or PRIVATE
.
- verified: Whether the creator’s profile is verified by TikTok.
- url: Direct link to the user’s TikTok profile.
By tapping into these attributes, you can give users a clear sense of a creator’s scale, authenticity, and content focus.
Example Request
Example Response
{
"id": 489,
"ok": true,
"url": "https://www.tiktok.com/@khaby.lame",
"domain": "tiktok.com",
"type": "TIKTOK_USER",
"status": 200,
"updatedAt": "2024-12-16T15:33:14.698Z",
"size": 563813,
"redirected": false,
"title": "Khabane lame (@khaby)",
"description": "If you want to laugh you are in the right place😎",
"icon": {
"url": "https://cdn.peekalink.io/ll2rf6emflby15bim0x0n1we/1284/favicon.png",
"width": 152,
"height": 152,
"backgroundColor": "#FFFFFF"
},
"image": {
"thumbnail": {
"width": 240,
"height": 240,
"url": "https://cdn.peekalink.io/xpdvs8tfe5q4zdwc9n1xife1/1416/e755d298d36b3175a2ca87d603b5dc2d~c5_720x720_thumbnail.jpeg"
},
"medium": {
"width": 404,
"height": 404,
"url": "https://cdn.peekalink.io/xpdvs8tfe5q4zdwc9n1xife1/1416/e755d298d36b3175a2ca87d603b5dc2d~c5_720x720_medium.jpeg"
},
"large": {
"width": 404,
"height": 404,
"url": "https://cdn.peekalink.io/xpdvs8tfe5q4zdwc9n1xife1/1416/e755d298d36b3175a2ca87d603b5dc2d~c5_720x720_large.jpeg"
},
"original": {
"width": 404,
"height": 404,
"url": "https://cdn.peekalink.io/xpdvs8tfe5q4zdwc9n1xife1/1416/e755d298d36b3175a2ca87d603b5dc2d~c5_720x720_original.jpeg"
}
},
"tiktokUser": {
"id": 20,
"username": "khaby",
"verified": true,
"name": "Khabane lame",
"bio": "If you want to laugh you are in the right place😎",
"url": "https://bit.ly/3Zn5cDf",
"followersCount": 162400000,
"followingCount": 79,
"likesCount": 2500000000,
"visibility": "PUBLIC",
"avatar": {
"thumbnail": {
"width": 240,
"height": 240,
"url": "https://cdn.peekalink.io/xpdvs8tfe5q4zdwc9n1xife1/1416/e755d298d36b3175a2ca87d603b5dc2d~c5_720x720_thumbnail.jpeg"
},
"medium": {
"width": 404,
"height": 404,
"url": "https://cdn.peekalink.io/xpdvs8tfe5q4zdwc9n1xife1/1416/e755d298d36b3175a2ca87d603b5dc2d~c5_720x720_medium.jpeg"
},
"large": {
"width": 404,
"height": 404,
"url": "https://cdn.peekalink.io/xpdvs8tfe5q4zdwc9n1xife1/1416/e755d298d36b3175a2ca87d603b5dc2d~c5_720x720_large.jpeg"
},
"original": {
"width": 404,
"height": 404,
"url": "https://cdn.peekalink.io/xpdvs8tfe5q4zdwc9n1xife1/1416/e755d298d36b3175a2ca87d603b5dc2d~c5_720x720_original.jpeg"
}
}
},
"requestId": "cm4r72o1q000710s1iightt5y"
}
Special Notes
- Fallback Strategies: If certain metadata fields are missing, Peekalink infers defaults to maintain a coherent preview.
- User Metrics: Leverage follower counts, like counts, and verification status to highlight established creators.
- Public vs. Private: Adjust how you present or link to user profiles based on the visibility field.
Schema reference
For a full technical breakdown of all fields and validation rules, including detailed JSON schemas, please refer to the API Reference.