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 の使い方
キーワードで検索し、一致したチャンネルをページ送りで読み取ります。
- {"query": "home cooking", "results_limit": 20} を /v1/youtube/search-channels に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 に渡すと、ビジネス用の連絡先を公開しているかどうかを確認できます。
関連API
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 Comments API
- YouTube Transcripts API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Trending Videos API