Skip to main content
GET
/
api
/
v1
/
users
/
by-id
/
{userId}
Get user profile by numeric user ID
curl --request GET \
  --url https://full-tiktok-api.p.rapidapi.com/api/v1/users/by-id/{userId} \
  --header 'x-rapidapi-key: <api-key>'
{
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2025-03-12T14:32:01.498Z",
    "cached": false,
    "version": "2025-01"
  },
  "data": {
    "user_id": "107955",
    "username": "charlidamelio",
    "display_name": "charli d'amelio",
    "website_url": "https://charlidamelio.com",
    "followers": 155000000,
    "following": 1200,
    "total_likes": 11000000000,
    "total_videos": 2400,
    "verified": true,
    "is_private": false,
    "bio": "just a girl who loves to dance",
    "avatar_url": "https://p16-sign.tiktokcdn-us.com/...",
    "avatar_thumb_url": "https://p16-sign.tiktokcdn-us.com/..."
  },
  "pagination": null,
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested resource was not found.",
    "details": null
  }
}
Returns a normalized public profile for the given numeric TikTok user ID. Useful when you have the user ID but not the username.

Authorizations

x-rapidapi-key
string
header
required

Your RapidAPI subscription key. Injected automatically by the RapidAPI gateway in production.

Path Parameters

userId
string<int64>
required

Numeric TikTok user ID (digits only)

Pattern: ^\d+$

Response

Success

meta
object

Response metadata present in every API response

data
object

A normalized TikTok user profile

pagination
object

Always null; this endpoint returns a single object and does not paginate.

Example:

null

error
object

Error details. Present only when the request failed; null on success.