youtube/
channels

チャンネルURLから公開YouTubeチャンネルのプロフィールを取得し、正規化されたチャンネル情報、説明、画像、認証状態、表示中のオーディエンス統計を返します。

YouTube Channels API

チャンネル
公開プロフィール
表示中の指標
結果1件あたり0.26クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

YouTube Channels

YouTubeチャンネルは、クリエイター、ブランド、組織の公開ページで、チャンネル情報、説明、画像、認証状態、プロフィールリンク、表示中のチャンネル登録者数・動画数・総視聴回数を持ちます。これらのチャンネル情報は、クリエイター調査、オーディエンス比較、ディレクトリの情報補完、市場分析に活用できます。

YouTube Channels API の主な機能

  • 複数チャンネルのプロフィール取得複数のチャンネルURLの公開プロフィールを、1回のリクエストでまとめて取得できます。
  • 正規化されたチャンネル情報チャンネルID、ハンドル、表示名、正規URL、説明、アイコン、バナーを一貫した構造で返します。
  • 公開チャンネル指標認証状態、公開されているチャンネル登録者数、公開動画数、チャンネルの総視聴回数を含みます。
  • プロフィールの補足フィールド公開されている所在地、プロフィールリンク、チャンネル作成日、送信したチャンネルURLを保持します。
  • 取得タイムスタンプすべての結果に collected_at を付与し、保存したレコードを取得日ごとに比較できるようにします。

YouTube Channels API のパラメータ

パラメータ必須説明
urls必須公開YouTubeチャンネルのURLです。カンマまたは改行で区切って指定します。

YouTube Channels API の使い方

公開チャンネルページのリストを、長く使えるチャンネル情報レコードに変換します。リクエストは非同期のため、送信したすべてのチャンネルの処理が完了するまでタスクIDを保持してください。

  1. 動画の視聴ページURLではなく、公開チャンネルまたは@ハンドルのURLを重複なしでリストにします。
  2. urls 配列を /v1/youtube/channels に POST し、返された task_id を保存します。
  3. /v1/tasks/{task_id} をポーリングします。queued と running は通常の途中状態です。
  4. タスクが成功したら 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=50

YouTube Channels API の主なユースケース

  • クリエイター・ブランドのディレクトリ: 固定のチャンネルID、プロフィール詳細、画像、リンク、公開オーディエンス指標でディレクトリの情報を補完します。
  • クリエイターの選定: 提携候補を評価する際に、チャンネルの説明、認証状態、公開オーディエンス規模、投稿活動、プロフィールリンクを確認します。
  • チャンネルの比較: クリエイター、ブランド、メディア、競合の間で、公開されているチャンネル登録者数・動画数・視聴回数を比較します。
  • プロフィールのモニタリング: 同じチャンネルを継続的に取得し、公開プロフィール情報とオーディエンス統計の変化を追跡します。

YouTube Channels API 活用のヒント

  • id を主キーとして保存してください。ハンドルは表示やルーティングに便利ですが、新しいチャンネルにならずに変更されることがあります。
  • 非表示のチャンネル登録者数を0に変換しないでください。null は値が公開されていなかったことを意味し、ビジネス上は別の意味を持つシグナルです。
  • 説明欄のリンクは信頼できない外部URLとして扱い、社内ツールに表示する前に検証・サニタイズしてください。
  • オーディエンス数値の比較は collected_at がある場合に限り、トレンドを計算する際は一定の取得間隔を保ってください。
  • チャンネルが削除、制限、または非公開になっている場合、成功したバッチでもレコード数がURL数より少なくなることがあります。
  • コンテンツの各行にプロフィールフィールドを繰り返し持たせるのではなく、チャンネルIDで Channels を Channel Videos や Shorts と結合してください。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Channels API — よくある質問

YouTube Channels APIは、1つ以上のYouTubeチャンネルURLから公開されているプロフィールデータを取得するAPIです。正規化されたチャンネル情報、説明、画像、認証状態、オーディエンス統計、所在地、プロフィールリンク、取得時刻を返します。

urls 配列に、公開YouTubeチャンネルのURLを1つ以上指定します。アクセス可能なチャンネルはそれぞれ個別の正規化された結果として返されます。

はい。同じ urls 配列に複数の公開チャンネルURLを追加すると、それらのプロフィールレコードをまとめて取得できます。

チャンネルはチャンネル登録者数を非表示にでき、任意の公開プロフィールフィールドもすべてのチャンネルにあるわけではありません。公開されていない値は0として報告されず、空のままになります。

いいえ。このエンドポイントが返すのはチャンネルのプロフィールデータと集計統計です。通常のアップロード動画には Channel Videos を、チャンネルのショートには Shorts を使用してください。

返された正規化チャンネル結果1件につき0.26クレジットです。