SocQはこれまでも、YouTubeの公開チャンネル、動画、ショート、コメント、検索、再生リスト、文字起こしを返してきました。これらはYouTube スクレイパーAPIおすすめ7選で比較しており、字幕テキストの一括取得はYouTube文字起こしガイドで解説しています。2026-11-17には、さらに8つのエンドポイントがYouTubeのプラットフォームページで公開されました。ショートのリサーチ、クリエイターの発掘とアウトリーチ、そしてクリエイターが動画の合間に公開するコミュニティ投稿といった、これまで手の届かなかった領域をカバーします。
このガイドでは、新しいエンドポイントを用途ごとにまとめ、それぞれのリクエスト例、料金、使いどころを紹介します。
結論:
POST https://api.socq.ai/v1/youtube/<endpoint>にJSONボディを送信します。返されたtask_idを保存し、statusがsucceededになるまでGET /v1/tasks/{task_id}をポーリングしてから、data.results.itemsを読み取ります。
新しいYouTubeエンドポイントの一覧
1 SocQクレジット = $0.005です。結果単位で課金されるエンドポイントには基本料金がないため、結果が空の場合は費用がかかりません。
| エンドポイント | 返す内容 | 料金 |
|---|---|---|
| YouTube Trending Shorts API | トレンドのショートの最新サンプルと、チャンネル、再生回数、高評価数、コメント数、長さ、公開日時 | ショート1本あたり0.5クレジット($0.0025) |
| YouTube Shorts Search API | キーワードに一致するショートと、リンク、キャプション、再生回数、縦型サムネイル | ショート1本あたり0.6クレジット($0.003) |
| YouTube Channel Search API | キーワードに一致するチャンネルと、ID、名前、登録者数、アバター、説明文の抜粋 | チャンネル1件あたり0.6クレジット($0.003) |
| YouTube Search Suggestions API | 入力途中のクエリに対する、言語・地域別の順位付きオートコンプリート候補 | 1回の呼び出しあたり0.5クレジット($0.0025) |
| YouTube Community Post API | 1件のコミュニティ投稿の本文全体、すべての画像、高評価数、チャンネル | 1回の呼び出しあたり0.5クレジット($0.0025) |
| YouTube Community Post Comments API | コミュニティ投稿に付いたコメントと、投稿者、高評価数、返信数 | コメント1件あたり0.3クレジット($0.0015) |
| YouTube Related Videos API | YouTubeがある動画の横におすすめとして表示する動画 | 動画1本あたり0.5クレジット($0.0025) |
| YouTube Email Finder API | チャンネルの公開ビジネス用メールアドレスと、それが見つかったページ | メールアドレスのあるチャンネル1件あたり15クレジット($0.075)。見つからない場合は無料 |
認証と非同期タスクの流れ
すべてのリクエストはAPIキーで認証します。送信、タスクのステータス確認、結果の取得のいずれにも同じヘッダーを使います。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
収集処理はすべてバックグラウンドのタスクとして実行されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信のリクエストは、data.task_id と data.status をすぐに返します。そのIDでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
status が succeeded になると、レスポンスには result_count、credits_amount、そして data.results.items に正規化されたレコードの最初のページが含まれます。limit のデフォルトは50で、最大500まで指定できます。results.has_more がtrueの場合は、results.next_cursor を cursor として渡すと次のページを読み取れます。失敗したタスクには error_message が含まれます。
以下のエンドポイントはすべて、任意の callback_url も受け付けます。タスクが完了すると、SocQはタスクの概要を1回POSTで送信します。レコードはタスクのエンドポイントから読み取ってください。クライアント側でタイムアウトしてもタスクはキャンセルされないため、再送信せずに同じタスクIDで再開してください。402 はアカウントのクレジット不足、429 はキーがレート制限またはクレジットの上限に達したことを意味します。
ショートと検索需要をリサーチする
Trending Shorts は、YouTubeがいまトレンドとして表示しているショートをサンプリングし、それぞれのタイトル、チャンネル、再生回数、高評価数、コメント数、長さ、公開日時を返します。すべてのフィールドは任意で、results_limit のデフォルトは48、最大200です。実行のたびに新しいサンプルを取るため、数分おいて2回実行しても重なるショートはわずかです。そのため、1回の大きな呼び出しよりも、定期実行のジョブのほうが1日を通して幅広い全体像をつかめます。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"results_limit": 48}'
Shorts Search は、キーワードに一致するショートをYouTubeの検索順で返し、リンク、キャプション、再生回数、縦型サムネイルを含みます。検索結果に含まれるのはこうした基本情報だけなので、高評価数、コメント数、チャンネルの詳細も必要な場合は、残したリンクをYouTube Videosに渡してください。results_limit のデフォルトは25です(1から200)。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "meal prep", "results_limit": 25}'
Search Suggestions は、クエリの書き出しに対してYouTubeの検索ボックスが提示する候補を、視聴者に表示される順位のまま返します。language のデフォルトは en、region のデフォルトは US です。これらを変更すると、同じキーワードが別の市場でどう広がるかを確認できます。候補の数にかかわらず、課金は1回の呼び出しにつき1回です。キーワードリサーチ、タイトル、タグの検討に使えます。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "iphone 17"}'
クリエイターを発掘して連絡先のメールアドレスを見つける
Channel Search は、キーワードに一致するチャンネルをYouTubeの表示順で検索し、チャンネルID、名前、登録者数、アバター、検索結果に表示される説明文の抜粋を返します。results_limit のデフォルトは20です(1から200)。クリエイター発掘の最初のステップとして、ここで候補を絞り込み、YouTube Channelsで詳細を、YouTube Channel Videosでアップロード動画を取得します。(ドキュメント)
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}'
Email Finder は、クリエイターが公開しているビジネス用メールアドレスを、チャンネルの説明文、リンクされたSNSプロフィール、リンクインバイオのページ、クリエイター自身のサイトから探します。emails に入る各アドレスには、それが見つかった source_urls が付きます。url には @handle 形式または /channel/UC... 形式のチャンネルリンクを指定します。公開メールアドレスが1件以上あるチャンネルは、見つかったすべてのアドレスを含む1件の結果を返し、15クレジット($0.075)かかります。1件も掲載していないチャンネルは空の結果を返し、課金されません。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/@mkbhd"}'
費用の例: 20チャンネルを検索し(12クレジット)、その20件すべてにEmail Finderを実行するとします。8件がメールアドレスを掲載していれば120クレジットとなり、合計は132クレジット($0.66)です。公開メールアドレスのない12チャンネルには費用がかかりません。
コミュニティ投稿とそのコメントを読み取る
Community Post は、リンクから1件の投稿を読み取り、本文全体、添付されたすべての画像、高評価数、投稿したチャンネルを返します。url には https://www.youtube.com/post/{post_id} 形式のリンク、または ?lb={post_id} を含むチャンネルの投稿タブのリンクを指定します。YouTube Community Postsの結果などで、すでに投稿のURLを持っている場合に使います。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'
Community Post Comments は、アンケート、お知らせ、画像の公開といった投稿に付いたコメントを収集し、各コメント投稿者のチャンネル、metrics.likes_count、metrics.replies_count を返します。投稿のコメントは動画のコメントとは別に管理されているため、クリエイターが動画の合間に発信する近況への反応は、このエンドポイントで読み取ります。URLの形式は同じものが使え、results_limit のデフォルトは100です(1から1000)。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'
YouTubeが次に何をおすすめするかを確認する
Related Videos は、YouTubeがある動画の横に「次に見る動画」として表示する一覧を、タイトル、チャンネル、再生回数、サムネイルとあわせて返します。url には watch、youtu.be、ショート、ライブのいずれかのリンクを指定します。1回の実行でおすすめ一覧全体(通常は約20本)が返り、動画単位で課金されるため、一般的な呼び出しの費用は約10クレジット($0.05)です。自社や競合のアップロード動画に実行すれば、YouTubeがどの動画やチャンネルを近いものと見なしているかがわかります。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
YouTubeの関連ガイド
SocQをほかのYouTubeデータプロバイダーと比較するには、YouTube APIの代替サービスおすすめ19選をご覧ください。フォロワーの国やフェイク再生数のチェックを含む、TikTok向けの同様の発掘・アウトリーチの流れは、TikTokの新エンドポイントガイドで解説しています。
よくある質問(FAQ)
公開メールアドレスのないチャンネルにも課金されますか?
いいえ。公開メールアドレスのないチャンネルは空の結果を返し、無料です。メールアドレスが1件以上あるチャンネルは、掲載されているアドレスの数にかかわらず15クレジットかかります。
Trending Shortsを2回実行すると、異なるショートが返るのはなぜですか?
実行のたびにその時点のトレンドをサンプリングするため、数分おいた実行どうしで重なるショートはわずかです。より幅広くカバーしたい場合は、複数回の実行をスケジュールしてください。
どのようなコミュニティ投稿のURLが使えますか?
https://www.youtube.com/post/{post_id}、または ?lb={post_id} を含むチャンネルの投稿タブのリンクです。
Shorts Searchは高評価数とコメント数を返しますか?
いいえ。検索結果に含まれるのは、リンク、キャプション、再生回数、サムネイルです。高評価数、コメント数、チャンネルの詳細が必要な場合は、リンクをYouTube Videosに渡してください。
Search Suggestionsはどのように課金されますか?
返される候補の数にかかわらず、1回の呼び出しあたり0.5クレジットです。