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を非同期タスクとして送信し、完了したタスクから正規化された返信レコードを読み取ります。
- 公開YouTube動画のURLと、その動画で返されたトップレベルコメントのIDを選びます。
- url、comment_id、results_limit を /v1/youtube/comment-replies に POST します。
- 返された task_id を保持し、タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングします。
- 成功したら 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 trueYouTube 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 を許容し、公開返信の本文は別の画面に表示する前にエスケープしてください。
関連API
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 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