YouTube Channel Videos
YouTubeチャンネルの動画は、特定のチャンネルによる通常のアップロード動画で、タイトル、説明、サムネイル、再生時間、公開情報、表示中のエンゲージメントを持ちます。これらのレコードは、チャンネルのカタログ化、投稿分析、コンテンツのモニタリング、過去データのレポートに活用できます。
YouTube Channel Videos API の主な機能
- 複数チャンネルの動画取得複数のチャンネルURLから、公開されている通常の動画を1回のリクエストでまとめて取得できます。
- チャンネルごとの件数上限入力チャンネルごとに個別の results_limit を設定できます。デフォルトは100です。
- 正規化された動画メタデータ正規化された動画ID、コンテンツのメタデータ、サムネイル、再生時間、公開日、投稿元チャンネルを返します。
- 特定時点のエンゲージメント指標公開されている視聴回数、高評価数、コメント数を collected_at とともに含み、後から比較できます。
- 通常の動画に限定ショートとライブ配信を除外し、チャンネルの通常の動画に絞った結果を返します。
YouTube Channel Videos API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 公開YouTubeチャンネルのURLです。カンマまたは改行で区切って指定します。 |
results_limit | 任意 | 入力URLごとに取得する対象レコードの最大件数です。正の整数で指定し、デフォルトは100です。 |
YouTube Channel Videos API の使い方
各チャンネルをどこまで遡って確認するかを決め、通常の動画だけのクリーンな一覧を取得します。1つのバッチに複数のチャンネルを含められますが、指定した上限はチャンネルごとに適用されます。
- 公開チャンネルのURLを用意し、最近のサンプルが必要か、過去まで遡る取得が必要かを決めます。
- urls と results_limit を /v1/youtube/channel-videos に POST します。上限はチャンネルごとに適用される点に注意してください。
- 一覧取得タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- 返された項目をチャンネルIDでグループ化し、動画IDで重複を排除して、has_more が true の間はページネーションを続けます。
curl -X POST "https://api.socq.ai/v1/youtube/channel-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50YouTube Channel Videos API の主なユースケース
- チャンネルのコンテンツフィード: 選定したチャンネルの公開されている通常の動画から、構造化されたフィードを構築します。
- 投稿・パフォーマンス分析: チャンネル間で、投稿頻度、再生時間、トピック、公開エンゲージメントを比較します。
- クリエイター・競合のモニタリング: クリエイター、パブリッシャー、ブランド、競合による通常の動画の投稿活動を追跡します。
- 動画カタログの作成: 各動画のURLを手作業で集めることなく、分類、要約、検索、レポートのワークフローにデータを投入します。
YouTube Channel Videos API 活用のヒント
- 上限は入力の数だけ掛け算になります。10チャンネルに results_limit 100 を指定すると、最大1,000件の通常動画レコードをリクエストすることになります。
- 新しいチャンネル群を取り込む際は浅い取得から始めて対象範囲を確認し、深い履歴が役立つチャンネルに限って上限を引き上げてください。
- 結果が少ないのは、チャンネル内の対象となる公開アップロードが少ないためである可能性があります。それだけでタスクの失敗を意味するわけではありません。
- 公開状況やチャンネル内の公開動画は変わりうるため、レスポンスを完全なアーカイブとして提示しないでください。
- 重複排除には動画IDを使用し、長期的な分析のために元のチャンネルIDと collected_at の両方を保持してください。
- フォーマットの構成比が重要な場合は、Shorts を別途実行してください。取得後に両者を組み合わせることで、分類が明確に保たれます。
- チャンネルの説明や数値をアップロードの各行にコピーするのではなく、現在のプロフィールフィールドには Channels を使用してください。
関連API
YouTube Channel Videos API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。
- YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
- YouTube Transcripts API — 取得可能なプレーンテキストの文字起こしを取得します。言語は任意で指定できます。
- YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
- YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
- YouTube Shorts API — チャンネルごとに、公開ショート、サムネイル、再生時間、公開情報、エンゲージメントを取得します。
- YouTube Channel Live Videos API — チャンネルのライブ欄に表示されている公開配信のレコードを、取得元の情報と表示中の指標とともに取得します。
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API