YouTube公開データAPI
対応する公開YouTubeのチャンネルプロフィール、動画の詳細、チャンネルの動画、コメント、ショート、キーワード・ハッシュタグの検索結果、取得可能な文字起こしを、正規化された1つの非同期ワークフローで取得できます。
利用できるYouTube API
チャンネルや動画の直接照会、チャンネル単位の動画・ショートの取得、公開コメント、キーワード・ハッシュタグによる検索、取得可能な文字起こしテキストから選べます。

youtube/channels
プロフィール結果1件あたり0.26クレジット

youtube/videos
投稿結果1件あたり0.5クレジット

youtube/channel-videos
投稿結果1件あたり0.5クレジット

youtube/playlist-videos
投稿結果1件あたり0.5クレジット

youtube/channel-live-videos
投稿結果1件あたり0.5クレジット

youtube/comments
コメント結果1件あたり0.3クレジット

youtube/comment-replies
コメント結果1件あたり0.5クレジット

youtube/community-posts
投稿結果1件あたり0.5クレジット

youtube/shorts
投稿結果1件あたり0.5クレジット

youtube/search
検索結果1件あたり0.5クレジット

youtube/hashtag-search
検索結果1件あたり0.5クレジット

youtube/transcripts
投稿結果1件あたり0.5クレジット

youtube/trending-shorts
投稿結果1件あたり0.5クレジット

youtube/community-post
投稿1リクエストあたり0.5クレジット

youtube/community-post-comments
コメント結果1件あたり0.3クレジット

youtube/related-videos
投稿結果1件あたり0.5クレジット

youtube/search-channels
検索結果1件あたり0.6クレジット

youtube/search-shorts
検索結果1件あたり0.6クレジット

youtube/search-suggestions
検索1リクエストあたり0.5クレジット

youtube/channel-email
プロフィール結果1件あたり15クレジット

youtube/trending-videos
投稿結果1件あたり0.5クレジット
取得できるYouTubeデータ
SocQは対応する公開YouTubeの結果を正規化レコードに変換し、情報補完、モニタリング、調査、コンテンツ分析、レポーティングに活用できるようにします。
チャンネルプロフィール
チャンネルの基本情報、説明文、公開画像、認証状態、表示中のチャンネル登録者数・動画数・総再生回数を取得します。
動画とショートのメタデータ
タイトル、説明文、チャンネルのコンテキスト、サムネイル、再生時間、公開日などの情報、表示中のエンゲージメントを取得します。
公開されている議論
公開されているコメント本文、投稿者のコンテキスト、高評価数、返信数、動画の参照、親コメントとの関係を取得します。
検索と文字起こし
キーワードで公開の通常動画を検索し、ハッシュタグフィードに関連する動画を取得できます。既知のURLについては、取得可能な字幕をプレーンテキストで取得します。
SocQ vs YouTube Data API
SocQは、対応する公開データの取得と正規化された結果に特化しています。公式のOAuth、チャンネル管理、認可が必要な操作には、YouTube Data APIが適しています。
| 機能 | SocQ | YouTube Data API |
|---|---|---|
| 主な用途 | 対応する公開データの取得と正規化 | 公式のプラットフォーム連携と認可済みリソース |
| 認証 | SocQのAPIキー | 操作に応じてGoogle OAuthまたはAPI認証情報 |
| コンテンツ管理 | YouTubeコンテンツの作成、編集、削除、高評価、コメント、管理は行いません | 対象となる認可済みの操作に対応 |
| 非公開・制限付きデータ | 非対応 | 付与された認可とプラットフォームポリシーで許可されたデータに限定 |
| レスポンス形式 | 正規化されたSocQレコード | YouTube API独自のリソース |
YouTube APIの仕組み
8つのエンドポイントはすべて、送信、ポーリング、カーソルページネーションという共通の非同期ライフサイクルを使用します。
1. 公開データの入力を送信
対応するチャンネルURL、動画URL、キーワードクエリ、ハッシュタグ、エンドポイントごとの任意のフィルターをPOSTします。
2. タスクをポーリング
返されたタスクIDを使い、処理が成功または失敗するまでポーリングします。一時的な負荷を示すレスポンスを受けた後はバックオフを適用してください。
3. 読み取りとページネーション
data.results.items から正規化レコードを読み取り、has_more が true の間は next_cursor をたどります。
SocQのAPIキーで認証します。このリクエストでは公開チャンネルのプロフィールを取得します。動画、コメント、ショート、キーワード・ハッシュタグ検索、文字起こしには、それぞれ別のエンドポイントを選択してください。
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 APIの主なユースケース
クリエイターとチャンネルの調査
公開チャンネルのプロフィール、通常動画、ショートを組み合わせて、ディレクトリの情報補完や比較分析に活用します。
コンテンツと反応のモニタリング
選んだ動画のメタデータ、公開コメントでの議論、取得時点のエンゲージメントのスナップショットを追跡します。
トピックの発掘
キーワードやハッシュタグフィードで公開動画を検索し、選んだURLの情報を補完したり、取得可能な文字起こしテキストを取得したりします。
データパイプライン
正規化レコードを、データウェアハウス、レビューツール、分類器、検索インデックス、レポーティングシステムに送信します。
制限事項と公開データポリシー
YouTubeの公開結果は動的に変化し、その時点の公開状態、分類、地域ごとの提供状況、公開字幕やコメントへのアクセス可否によって異なります。
- 非公開、削除済み、メンバー限定、地域制限、年齢制限、その他アクセスできないコンテンツでは、レコードが返らない場合があります。
- 表示中のカウンター、検索順位、分類、コメント、字幕は、取得後に変わる場合があります。
- 指定した結果の上限件数は、その件数の対象公開レコードが存在することを保証するものではありません。
- SocQは公式のYouTube APIではなく、YouTubeコンテンツの管理、作成、変更、削除、高評価、コメントは行いません。
YouTube APIに関するよくある質問
SocQは公式のYouTube APIですか?
いいえ。SocQは対応する公開結果を取得して正規化するサービスです。公式のOAuth、チャンネル管理、認可が必要な操作には、YouTube Data APIを利用してください。
ユーザーがYouTubeアカウントを連携する必要はありますか?
いいえ。対応するこれらの公開データのエンドポイントでは、顧客側のYouTube OAuthは不要です。リクエストはSocQのAPIキーで認証します。
どのYouTubeリソースを利用できますか?
Channels、Videos、Channel Videos、Comments、Shorts、Search、Hashtag Search、Transcriptsを利用でき、それぞれ入力と正規化結果の仕様がドキュメント化されています。
料金はどのように計算されますか?
各エンドポイントのカードに、現在の結果1件あたりのクレジット料金が表示されています。また、Playgroundでは、エンドポイントの課金ルールに基づいて送信リクエストの料金を見積もれます。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Facebook API
公開Facebookページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。
X API
公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。
LinkedIn API
既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。
Reddit API
既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。
Pinterest API
公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。
Threads API
公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。