Get TikTok Creator Profile (Realtime)

Collects a TikTok creator's profile directly from the platform at request time instead of reading the persisted database. Use it when freshness matters more than throughput; realtime calls consume more quota than database reads.

GET/api/v1/tiktok/realtime/user/info

Quota usage: Each successful request to this endpoint deducts 100 quota units from your plan.

Platform Path Family

/api/v1/{platform}/realtime/user/info

Available Platforms

Request Parameters

Required Parameters

This endpoint has no required parameters.

Optional Parameters

Name	In	Type	Description
`unique_id`	query	string	unique_id example: nike
`user_id`	query	string	user_id example: 208464585232822272

Response Fields

Name	Type	Description
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.uid`	string	uid
`data.unique_id`	string	unique_id
`data.sec_uid`	string	sec_uid
`data.nickname`	string	Nickname
`data.profile_url`	string	Profile URL
`data.avatar`	string	Avatar
`data.description`	string	Bio
`data.verified`	boolean	Verified
`data.country`	string	Country
`data.follower_count`	integer	Follower count
`data.following_count`	integer	Following count
`data.total_favorited`	integer	Like count
`data.video_count`	integer	Video count

Try It

Request URL

https://openapi.scdata.cc/api/v1/tiktok/realtime/user/info

Authorization

Select an API key from Dashboard

Add an API key before sending a request.Go to Dashboard

Query Params

unique_id

user_id

cURL Example

bash

curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/realtime/user/info" \
  -H "Authorization: YOUR_API_KEY"

Response Example (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "uid": "string",
    "unique_id": "string",
    "sec_uid": "string",
    "nickname": "string",
    "profile_url": "string",
    "avatar": "string",
    "description": "string",
    "verified": true,
    "country": "string",
    "follower_count": 0,
    "following_count": 0,
    "total_favorited": 0,
    "video_count": 0
  }
}

Use Cases

Pre-campaign refresh — Refresh a shortlisted creator's numbers right before signing a deal so the contract reflects today's audience size.
Filling database gaps — When the database lookup returns nothing for a creator, trigger a live collection to obtain the profile.