YouTube Channels
YouTubeチャンネルは、クリエイター、ブランド、組織の公開ページで、チャンネル情報、説明、画像、認証状態、プロフィールリンク、表示中のチャンネル登録者数・動画数・総視聴回数を持ちます。これらのチャンネル情報は、クリエイター調査、オーディエンス比較、ディレクトリの情報補完、市場分析に活用できます。
YouTube Channels API の主な機能
- 複数チャンネルのプロフィール取得複数のチャンネルURLの公開プロフィールを、1回のリクエストでまとめて取得できます。
- 正規化されたチャンネル情報チャンネルID、ハンドル、表示名、正規URL、説明、アイコン、バナーを一貫した構造で返します。
- 公開チャンネル指標認証状態、公開されているチャンネル登録者数、公開動画数、チャンネルの総視聴回数を含みます。
- プロフィールの補足フィールド公開されている所在地、プロフィールリンク、チャンネル作成日、送信したチャンネルURLを保持します。
- 取得タイムスタンプすべての結果に collected_at を付与し、保存したレコードを取得日ごとに比較できるようにします。
YouTube Channels API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 公開YouTubeチャンネルのURLです。カンマまたは改行で区切って指定します。 |
YouTube Channels API の使い方
公開チャンネルページのリストを、長く使えるチャンネル情報レコードに変換します。リクエストは非同期のため、送信したすべてのチャンネルの処理が完了するまでタスクIDを保持してください。
- 動画の視聴ページURLではなく、公開チャンネルまたは@ハンドルのURLを重複なしでリストにします。
- urls 配列を /v1/youtube/channels に POST し、返された task_id を保存します。
- /v1/tasks/{task_id} をポーリングします。queued と running は通常の途中状態です。
- タスクが成功したら data.results.items を id でインデックス化し、has_more が true の場合は next_cursor を使って続きを取得します。
curl -X POST "https://api.socq.ai/v1/youtube/channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"]}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50YouTube Channels API の主なユースケース
- クリエイター・ブランドのディレクトリ: 固定のチャンネルID、プロフィール詳細、画像、リンク、公開オーディエンス指標でディレクトリの情報を補完します。
- クリエイターの選定: 提携候補を評価する際に、チャンネルの説明、認証状態、公開オーディエンス規模、投稿活動、プロフィールリンクを確認します。
- チャンネルの比較: クリエイター、ブランド、メディア、競合の間で、公開されているチャンネル登録者数・動画数・視聴回数を比較します。
- プロフィールのモニタリング: 同じチャンネルを継続的に取得し、公開プロフィール情報とオーディエンス統計の変化を追跡します。
YouTube Channels API 活用のヒント
- id を主キーとして保存してください。ハンドルは表示やルーティングに便利ですが、新しいチャンネルにならずに変更されることがあります。
- 非表示のチャンネル登録者数を0に変換しないでください。null は値が公開されていなかったことを意味し、ビジネス上は別の意味を持つシグナルです。
- 説明欄のリンクは信頼できない外部URLとして扱い、社内ツールに表示する前に検証・サニタイズしてください。
- オーディエンス数値の比較は collected_at がある場合に限り、トレンドを計算する際は一定の取得間隔を保ってください。
- チャンネルが削除、制限、または非公開になっている場合、成功したバッチでもレコード数がURL数より少なくなることがあります。
- コンテンツの各行にプロフィールフィールドを繰り返し持たせるのではなく、チャンネルIDで Channels を Channel Videos や Shorts と結合してください。
関連API
YouTube Channels API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。
- YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
- YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
- YouTube Transcripts API — 取得可能なプレーンテキストの文字起こしを取得します。言語は任意で指定できます。
- YouTube Shorts API — チャンネルごとに、公開ショート、サムネイル、再生時間、公開情報、エンゲージメントを取得します。
- YouTube Community Posts API — チャンネルURLから、コミュニティタブの公開投稿を、テキスト、チャンネル情報、タイムスタンプ、画像の参照、取得元の情報とともに取得します。
- YouTube Email Finder API — チャンネルURLから公開されているビジネス用メールアドレスを探し、各アドレスが掲載されているページとあわせて返します。
- YouTube Videos API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies 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 Trending Videos API