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

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

GET/api/v1/youtube/realtime/user/info

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 100 単位消費されます。

プラットフォーム共通パス

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

利用可能なプラットフォーム

リクエストパラメータ

必須パラメータ

このエンドポイントに必須パラメータはありません。

任意パラメータ

名前	位置	型	説明
`channel_id`	query	string	channel_id example: UCUFgkRb0ZHc4Rpq15VRCICA
`username`	query	string	username example: nike

レスポンスフィールド

名前	型	説明
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.channel_id`	string	Channel ID
`data.username`	string	Channel handle
`data.title`	string	Channel name
`data.profile_url`	string	Channel URL
`data.description`	string	Channel description
`data.subscriber_count`	integer	Subscriber count
`data.video_count`	integer	Video count
`data.country`	string	Country

お試し実行

リクエストURL

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

Authorization

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

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

クエリパラメータ

channel_id

username

cURL の例

bash

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

レスポンス例 (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "channel_id": "string",
    "username": "string",
    "title": "string",
    "profile_url": "string",
    "avatar": "string",
    "description": "string",
    "subscriber_count": 0,
    "video_count": 0,
    "country": "string"
  }
}

ユースケース

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