TikTok Scraper
Get TikTok Profile
Fetches public profile data for a TikTok user by their handle or user_id — useful for looking up a creator's identity, bio, and account stats. Returns a `user` object (display name, avatar URLs, bio/signature, verification status, bio link) and a `stats` object (followerCount, followingCount, heartCount/total likes, videoCount). This only returns profile metadata, not the user's actual videos or followers list.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| handlestring · optional | string | optional | TikTok handle. You can pass handle or user_id. |
| user_idstring · optional | string | optional | TikTok user id. |
| cache_max_agestring · optional | string | optional | See the Caching page for details. One of: |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"user": {
"type": "object",
"additionalProperties": {}
},
"stats": {
"type": "object",
"additionalProperties": {}
},
"itemList": {
"type": "array"
}
},
"additionalProperties": true
}