YouTube Comments
YouTubeコメントは、動画に対する視聴者の公開された反応で、本文、投稿者情報、投稿日時、表示中の高評価数、返信数、元動画の詳細、会話の関係を持ちます。これらのディスカッション情報は、フィードバック分析、オーディエンス調査、トピックの確認、反応のモニタリングに活用できます。
YouTube Comments API の主な機能
- 複数動画のコメント取得複数の動画URLから公開コメントを1回のリクエストでまとめて取得できます。
- 動画ごとの上限と並び順動画ごとの results_limit を設定し、新しい順または関連度順を選択できます。
- コメントと投稿者のフィールドコメントID、本文、公開されている投稿者情報、投稿日時、元動画の情報を返します。
- スレッドの関係公開されている高評価数、返信数、親コメントIDを含み、構造化されたディスカッション分析に使えます。
- クリエイターとの交流を示す指標公開結果に含まれる場合、チャンネル所有者の表示やクリエイターのハートの有無を保持します。
YouTube Comments API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | コメントが表示されている公開YouTube動画のURLです。カンマまたは改行で区切って指定します。 |
results_limit | 任意 | 入力URLごとに取得する対象レコードの最大件数です。正の整数で指定し、デフォルトは100です。 |
sort_by | 任意 | コメントの並び順です。デフォルトは newest で、relevance はYouTubeの公開ランキングを使用します。 |
YouTube Comments API の使い方
新しさと注目度のどちらを重視するかを決め、動画ごとのサンプル数を設定し、コメントを分析パイプラインに取り込む際は返された関係を保ったまま扱ってください。
- 公開動画のURLを選び、最新の反応が必要か、YouTubeがランク付けしたディスカッションが必要かを決めます。
- urls、results_limit、sort_by を /v1/youtube/comments に POST します。上限はすべての動画に適用されます。
- /v1/tasks/{task_id} をポーリングします。コメントが有効な動画と、コメント欄が利用できない動画は同じバッチ内で処理されます。
- 成功したらコメントIDで重複を排除し、parent_comment_id で返信を紐づけ、has_more が true の間はページネーションを続けます。
curl -X POST "https://api.socq.ai/v1/youtube/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"results_limit":10,"sort_by":"newest"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50YouTube Comments API の主なユースケース
- オーディエンスのフィードバック分析: 公開コメントの本文を分析し、感情、繰り返し出る質問、テーマ、コンテンツのアイデアを見つけます。
- キャンペーン・イベントのモニタリング: クリエイター、製品発表、キャンペーン、告知、イベントに対する公開された反応を追跡します。
- ディスカッション調査: 高評価数、返信数、親コメントの参照を使い、エンゲージメントの高いコメントや活発なスレッドを調査します。
- テキスト分析用データセット: 正規化されたコメントを、分類、クラスタリング、要約、モデレーション支援、アラートのワークフローに提供します。
YouTube Comments API 活用のヒント
- 分析の前に sort_by を決めてください。relevance から newest に切り替えるとサンプル自体が変わるため、並び順が変わっただけのように2つのエクスポートを比較しないでください。
- results_limit は動画ごとの上限として扱ってください。コメントの無効化、モデレーション、ランキング、制限、活動の少なさによって、返される件数が減ることがあります。
- 重複排除にはコメントIDを、紐づけには parent_comment_id を使いますが、表示されている返信がすべて同じ結果ページに含まれるとは限りません。
- 高評価数と返信数は取得時点の観測値であり、感情や重要度を示す固定的な尺度ではありません。
- コメント本文と投稿者フィールドは信頼できない公開入力です。画面上ではエスケープし、含まれるURLは使用前に検証してください。
- キーワード一致は感情分析ではありません。ラベル付けや要約を行う際は、元の本文と出典の文脈を保持してください。
- どの会話サンプルを確認したかをアナリストが再現できるよう、すべての行に動画IDと collected_at を残してください。
関連API
YouTube Comments API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。
- YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
- YouTube Transcripts API — 取得可能なプレーンテキストの文字起こしを取得します。言語は任意で指定できます。
- YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
- YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
- YouTube Comment Replies API — 返信トークンから既知のYouTubeコメントスレッドの続きを取得し、公開返信、投稿者、エンゲージメント、親コメントの情報を返します。
- YouTube Community Post Comments API — コミュニティ投稿のリンクから、その下のコメントを収集し、コメントしたチャンネル、高評価数、返信数を返します。
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API