youtube/
search-channels

キーワードでYouTubeチャンネルを検索し、チャンネルID、チャンネル名、チャンネル登録者数、アイコン、YouTubeに表示される説明文の抜粋を検索順で取得します。

YouTube Channel Search API

キーワードで入力
チャンネル登録者数
最大200チャンネル
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

YouTube Channel Search

チャンネル検索の結果は、YouTubeがキーワードに一致すると判断したクリエイターのアカウントで、それぞれチャンネル名、アイコン、チャンネル登録者数、説明文の冒頭とともに表示されます。結果に目を通せば、あるテーマを誰が扱っているかをすばやく把握し、大規模なチャンネルと伸び盛りのチャンネルを見分け、クリエイター調査や依頼のための最初のリストを作れます。

YouTube Channel Search API の主な機能

  • チャンネルだけを検索検索対象をチャンネルに限定しているため、home cooking のようなキーワードでも、動画や再生リストが混ざらずクリエイターのアカウントだけが返ります。
  • チャンネルごとの登録者数metrics.followers_count には、3.69M のようなYouTubeの表示から換算したチャンネル登録者数が入ります。
  • 変わらないチャンネルIDとリンク各結果には UC で始まるチャンネルIDと、それをもとにしたチャンネルURLが含まれ、そのままチャンネル単位のAPIに渡せます。
  • 説明文の抜粋text には検索結果に表示される説明文の抜粋が入ります。ジャンル名やビジネス用の連絡先が書かれていることもよくあります。

YouTube Channel Search API のパラメータ

パラメータ必須説明
query必須チャンネルを探すキーワードです。最大100文字です。
results_limit任意返すチャンネルの件数です。1〜200で指定でき、デフォルトは20です。

YouTube Channel Search API の使い方

キーワードで検索し、一致したチャンネルをページ送りで読み取ります。

  1. {"query": "home cooking", "results_limit": 20} を /v1/youtube/search-channels に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からチャンネルを読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home cooking","results_limit":20}'

# Each item is one channel with name, text and metrics.followers_count.

YouTube Channel Search API の主なユースケース

  • クリエイター候補リストの作成: 自分のジャンルのキーワードで検索し、followers_count が対象とする規模に収まるチャンネルを残します。
  • テーマの主要チャンネルの把握: キーワードの上位結果のチャンネル登録者数を比べ、少数の大規模チャンネルが占めているかどうかを判断します。
  • チャンネル調査の起点づくり: 返されたチャンネルURLを YouTube Channels と YouTube Channel Videos に渡し、各クリエイターを詳しく分析します。

YouTube Channel Search API 活用のヒント

  • チャンネル登録者数は丸められた表示用の文字列から換算しているため、1人単位の正確な数値が必要な場合は YouTube Channels を使用してください。
  • 同じテーマを複数の言い回しで検索し、チャンネルの id で結果を統合すると、リストを広げられます。
  • 有望なチャンネルを YouTube Email Finder に渡すと、ビジネス用の連絡先を公開しているかどうかを確認できます。

YouTube Channel Search API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。

  • YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
  • YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
  • YouTube Search API — キーワードで通常の公開動画を検索します。対応するメタデータのフィルターを指定できます。
  • YouTube Hashtag Search API — ハッシュタグフィードから公開動画を探します。すべてのコンテンツか、ショートのみかを選んで取得できます。
  • YouTube Shorts Search API — キーワードでショートを検索し、リンク、キャプション、視聴回数、縦長のサムネイルを返します。
  • YouTube Email Finder API — チャンネルURLから公開されているビジネス用メールアドレスを探し、各アドレスが掲載されているページとあわせて返します。

他のプラットフォームを見る

YouTubeのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Channel Search API — よくある質問

YouTube Channel Search APIは、キーワードに一致するYouTubeチャンネルを探すためのプログラムインターフェースです。チャンネルID、チャンネル名、チャンネル登録者数、アイコン、説明文の抜粋をYouTubeの検索順で返します。

results_limit は1〜200の範囲で指定でき、デフォルトは20です。上限に達するか、YouTubeの検索結果が終わるまで自動的にページ送りします。

検索結果では、チャンネルは UC で始まるチャンネルIDとチャンネルURLで識別されます。ハンドルやプロフィール全体が必要な場合は、そのURLを YouTube Channels に送信してください。

必要ありません。リクエストにはSocQのAPIキーを使い、返されたチャンネル数に応じてクレジットが消費されるため、Google Cloudのプロジェクトや1日あたりのクォータを管理する必要はありません。

返されたチャンネル1件につき0.6クレジットです。デフォルトの20件なら12クレジットになります。