实时获取TikTok红人账号资料

在请求时直接从 TikTok 平台采集红人资料，而不是读取持久化库。当数据新鲜度比吞吐量更重要时使用；实时调用消耗的配额高于库内读取。

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

额度扣减: 本接口每次成功请求会从套餐额度中扣减 100 单位。

平台路径族

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

可切换平台

请求参数

必填参数

该接口没有必填参数。

可选参数

名称	位置	类型	说明
`unique_id`	query	string	unique_id example: nike
`user_id`	query	string	user_id example: 208464585232822272

响应字段

名称	类型	说明
`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

在线调试

请求地址

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

鉴权

请先从 Dashboard 选择一个 API key

发送请求前请先准备一个 API key。前往 Dashboard

查询参数

unique_id

user_id

cURL 示例

bash

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

响应示例 (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
  }
}

使用场景

投放前刷新 — 在签约前刷新候选红人的最新数据，让合同依据当天的粉丝规模。
补齐库内缺口 — 当库内查询没有该红人的记录时，触发实时采集获取资料。