リクエスト時にYouTubeからクリエイターの最新動画を直接取得します。数時間以内に公開されたコンテンツや、データベースの値が古い場合に使用してください。リアルタイム収集はデータベース読み取りより多くのクォータを消費します。
GET
/api/v1/youtube/realtime/user/videosクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 100 単位消費されます。
プラットフォーム共通パス
/api/v1/{platform}/realtime/user/videos利用可能なプラットフォーム
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
channel_id | query | string | channel_id example: UCUFgkRb0ZHc4Rpq15VRCICA |
任意パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
offset | query | string | offset |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.more | boolean | Has more |
data.offset | string | offset |
data.videos | array<object> | videos |
お試し実行
https://openapi.scdata.cc/api/v1/youtube/realtime/user/videos
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
channel_id*offsetcURL の例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/youtube/realtime/user/videos?channel_id=UCUFgkRb0ZHc4Rpq15VRCICA" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"more": true,"offset": "string","videos": [{"video_id": "string","title": "string","description": "string","create_at": "2019-08-24T14:15:22.123Z","channel_title": "string","channel_id": "string"}]}}
ユースケース
- キャンペーン納品確認 — スポンサー投稿が公開されたことを確認し、公開直後のエンゲージメントを記録します。
- トレンド把握 — 複数のクリエイターの最新動画を定期取得し、新しいトピックを早期に発見します。