TikTokクリエイターのプロフィールを取得（リアルタイム）

持久化データベースではなく、リクエスト時にTikTokから直接クリエイターのプロフィールを収集します。鮮度が重要な場合に使用してください。リアルタイム呼び出しはデータベース読み取りより多くのクォータを消費します。

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

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 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

お試し実行

リクエストURL

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

Authorization

ダッシュボードのAPIキーを選択

リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

クエリパラメータ

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
  }
}

ユースケース

キャンペーン前の更新 — 契約直前に候補クリエイターの数値を更新し、当日のオーディエンス規模を契約に反映します。
データベースの欠落補完 — データベース検索でクリエイターが見つからない場合、リアルタイム収集でプロフィールを取得します。