youtube/
comment-replies

固定の動画URLと親コメントIDから公開YouTube返信を取得し、本文、投稿者、エンゲージメント、タイムスタンプ、スレッドの文脈を返します。

YouTube Comment Replies API

固定のコメント入力
公開返信
スレッドの文脈
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

YouTube Comment Replies

YouTubeコメントへの返信は、動画のトップレベルコメントの下にネストされた公開の応答で、返信本文、投稿者情報、表示中の高評価数、投稿日時、親コメントや動画の文脈を持ちます。これらのスレッドレコードは、会話の再構成、反応の確認、公開ディスカッションのデータセット作成に活用できます。

YouTube Comment Replies API の主な機能

  • 固定のコメント参照公開動画URLと親コメントIDから開始でき、現在の返信用の継続トークンはSocQが内部で解決します。
  • 返信と投稿者のレコード返信ID、公開本文、関連URL、投稿日時、正規化された投稿者またはチャンネルの情報を返します。
  • スレッドとクリエイターの文脈表示中の高評価数、ネストされた返信数、親コメントと動画の参照、チャンネル所有者やクリエイターのハートの表示をまとめて保持します。
  • 範囲を限定した継続取得取得元の後続の継続トークンをたどり、重複する返信IDを除外して、選択した上限、スレッドの終端、100ページの上限のいずれかで停止します。

YouTube Comment Replies API のパラメータ

パラメータ必須説明
url必須必須。親コメントを含む、固定の公開YouTube動画URLです。
comment_id必須必須。送信した動画URLに属するトップレベルコメントのIDです。
results_limit任意このスレッドから取得する公開返信の最大件数です。ドキュメントの例では20を使用しており、指定できる範囲は20〜2000です。

YouTube Comment Replies API の使い方

固定の動画URLと親コメントIDを非同期タスクとして送信し、完了したタスクから正規化された返信レコードを読み取ります。

  1. 公開YouTube動画のURLと、その動画で返されたトップレベルコメントのIDを選びます。
  2. url、comment_id、results_limit を /v1/youtube/comment-replies に POST します。
  3. 返された task_id を保持し、タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングします。
  4. 成功したら data.results.items を読み取り、data.results.has_more が true の間は data.results.next_cursor をタスクリクエストの cursor として渡します。
curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","comment_id":"Ugzge340dBgB75hWBm54AaABAg","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is true

YouTube Comment Replies API の主なユースケース

  • 既知スレッドの再構成: 返信ID、parent_comment_id、video_id、URL、タイムスタンプを使い、保存した返信を選択したトップレベルコメントに再び紐づけます。
  • 返信単位でのオーディエンス確認: 1つの既知のスレッド内で、公開返信の本文、投稿者情報、表示中の高評価数、ネストされた返信数、クリエイターとの交流を示す表示を比較します。
  • 公開ディスカッションのデータセット作成: 正規化された返信本文、投稿者、タイムスタンプ、スレッドの文脈を組み合わせ、手作業での確認や後段のテキスト処理に使うレコードを作成します。

YouTube Comment Replies API 活用のヒント

  • 返信スレッドと元の動画の対応がずれないよう、動画URLとトップレベルコメントIDは必ずペアで扱ってください。
  • 現在の継続トークンはSocQが内部で解決します。上流のトークンが期限切れになった場合は、同じ固定の参照でリトライしてください。
  • 元のコメントIDと、GET /v1/tasks/{task_id} が返す cursor は区別してください。前者はYouTubeの返信スレッドを選択するもので、後者は保存済みのタスク結果をページ送りするものです。
  • results_limit は想定されるスレッドの規模に合わせて設定しますが、公開状況やスレッドの終端によって返される件数が減ることがあるため、上限として扱ってください。
  • 保存したレコードは返信IDで重複排除し、返信を元のコメントに結合する際は parent_comment_id、video_id、extra.reply_token を保持してください。
  • 投稿者、タイムスタンプ、指標、クリエイター表示のフィールドは null を許容し、公開返信の本文は別の画面に表示する前にエスケープしてください。

YouTube Comment Replies API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。

  • YouTube Channel Videos API — チャンネルURLから、ショートとライブ配信を除く通常の公開動画を取得します。
  • YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
  • YouTube Transcripts API — 取得可能なプレーンテキストの文字起こしを取得します。言語は任意で指定できます。
  • YouTube Channels API — 公開チャンネルのアカウント情報、画像、認証状態、表示中のオーディエンス統計を取得します。
  • YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
  • YouTube Community Post Comments API — コミュニティ投稿のリンクから、その下のコメントを収集し、コメントしたチャンネル、高評価数、返信数を返します。

他のプラットフォームを見る

YouTubeのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Comment Replies API — よくある質問

YouTube Comment Replies APIは、YouTubeのトップレベルコメント1件に対する公開返信を取得するためのプログラムインターフェースです。固定の動画URLとコメントIDを送信すると、返信本文、投稿者情報、表示中のエンゲージメント、タイムスタンプ、スレッドの文脈を受け取れます。

公開動画のURLで YouTube Comments API を実行し、同じ動画について返された対応するトップレベルコメントのIDを使用してください。

いいえ。SocQは送信された動画URLとコメントIDから現在の継続トークンを解決します。従来のトークン入力はAPIの互換性のために残っていますが、このプレイグラウンドでは使用しません。

results_limit には20〜2000の整数を指定でき、ドキュメントのプレイグラウンドの例では20を送信しています。取得は、その上限に達したとき、公開スレッドが終わったとき、または取得元の100ページ分を処理した後に停止します。

返信には、ID、URL、本文、公開されている投稿者またはチャンネルの詳細、表示中の高評価数とネストされた返信数、投稿日時と取得日時に加え、extra 内の動画、親コメント、クリエイター表示、トークンの文脈が含まれる場合があります。

いいえ。comment_id は取得元のYouTube返信スレッドを選択するもので、cursor は成功したSocQタスクにすでに保存された正規化レコードをページ送りするものです。

親コメントが返信トークンを公開していない、スレッドが results_limit に達する前に終わっている、または返信が削除済み、非表示、確認待ち、メンバー限定、無効化されているなど、公開されていない状態である可能性があります。

保存された正規化返信1件につき0.5クレジットです。請求は実際に保存されたレコード数に基づくため、結果が空の場合は結果単位の課金は発生しません。