youtube/
comments

1つ以上の動画URLから公開YouTubeコメントを取得し、正規化された本文、投稿者、高評価数、返信数、元の動画、会話の文脈を返します。

YouTube Comments API

コメント
ディスカッションデータ
動画URL
結果1件あたり0.3クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 の使い方

新しさと注目度のどちらを重視するかを決め、動画ごとのサンプル数を設定し、コメントを分析パイプラインに取り込む際は返された関係を保ったまま扱ってください。

  1. 公開動画のURLを選び、最新の反応が必要か、YouTubeがランク付けしたディスカッションが必要かを決めます。
  2. urls、results_limit、sort_by を /v1/youtube/comments に POST します。上限はすべての動画に適用されます。
  3. /v1/tasks/{task_id} をポーリングします。コメントが有効な動画と、コメント欄が利用できない動画は同じバッチ内で処理されます。
  4. 成功したらコメント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=50

YouTube Comments API の主なユースケース

  • オーディエンスのフィードバック分析: 公開コメントの本文を分析し、感情、繰り返し出る質問、テーマ、コンテンツのアイデアを見つけます。
  • キャンペーン・イベントのモニタリング: クリエイター、製品発表、キャンペーン、告知、イベントに対する公開された反応を追跡します。
  • ディスカッション調査: 高評価数、返信数、親コメントの参照を使い、エンゲージメントの高いコメントや活発なスレッドを調査します。
  • テキスト分析用データセット: 正規化されたコメントを、分類、クラスタリング、要約、モデレーション支援、アラートのワークフローに提供します。

YouTube Comments API 活用のヒント

  • 分析の前に sort_by を決めてください。relevance から newest に切り替えるとサンプル自体が変わるため、並び順が変わっただけのように2つのエクスポートを比較しないでください。
  • results_limit は動画ごとの上限として扱ってください。コメントの無効化、モデレーション、ランキング、制限、活動の少なさによって、返される件数が減ることがあります。
  • 重複排除にはコメントIDを、紐づけには parent_comment_id を使いますが、表示されている返信がすべて同じ結果ページに含まれるとは限りません。
  • 高評価数と返信数は取得時点の観測値であり、感情や重要度を示す固定的な尺度ではありません。
  • コメント本文と投稿者フィールドは信頼できない公開入力です。画面上ではエスケープし、含まれるURLは使用前に検証してください。
  • キーワード一致は感情分析ではありません。ラベル付けや要約を行う際は、元の本文と出典の文脈を保持してください。
  • どの会話サンプルを確認したかをアナリストが再現できるよう、すべての行に動画IDと collected_at を残してください。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Comments API — よくある質問

YouTube Comments APIは、1つ以上のYouTube動画URLから公開されているコメントを取得するAPIです。正規化された本文、投稿者情報、投稿日時、高評価数、返信数、元動画の参照、親コメントID、取得時刻を返します。

1つ以上の公開YouTube動画URLに加え、任意で results_limit と sort_by の値を指定します。

新しい順にするには newest を、YouTubeの公開関連度順にするには relevance を指定します。デフォルトは newest です。

返信のレコードには parent_comment_id が含まれる場合があり、replies_count はコメントに紐づく公開返信の件数を示します。

results_limit は動画ごとの最大値です。コメントが無効化、フィルタ、制限されている動画や、公開コメントが少ない動画では、返されるレコードが少なくなるか、結果が空になることがあります。

返された正規化コメント結果1件につき0.3クレジットです。