YouTube コメント検索 API

認証付き GET 1 回で公開 YouTube 動画のコメントを JSON として返します——投稿者、テキスト、エンゲージメントカウンター、毎回最大 50 件。

単一 REST エンドポイント
構造化コメント項目
調整可能な結果件数
任意の公開動画で動作
予測可能なエラーコード
5 言語のサンプル

リクエスト例

curl "https://api.agentbody.io/v1/youtube/comments?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&max_results=1" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"

レスポンス例

OpenAPI 仕様に記載されたレスポンス。

Public top-level comments for one YouTube video.

{
  "items": [
    {
      "author": "Example Author",
      "id": "UgkxExample",
      "like_count": 12,
      "reply_count": 2,
      "text": "Great video!"
    }
  ],
  "total": 1,
  "video_id": "dQw4w9WgXcQ"
}

機能特徴

YouTube コメント検索 API をオーディエンス調査、感情パイプライン、モデレーションツールに使う——動画 URL を入れ、構造化コメントを得る。

単一 REST エンドポイント

bearer API キーと公開動画 URL を付けて GET /v1/youtube/comments を呼びます。API はコメント欄を構造化 JSON として返します。YouTube Data API のクォータ管理もスクレイピング基盤の維持も不要です。

構造化コメント項目

各項目は id、author、text、like_count、reply_count を運び、レスポンスは video_id と total を報告します。項目をそのまま検索インデックス、感情パイプライン、スプレッドシートに落とし込めます。

調整可能な結果件数

ワークロードに合わせて毎回の max_results を 1〜50 に設定します。手軽な確認には小さなサンプル、一括分析には 50 まで。コメント欄が上限より小さい場合、ゲートウェイはより少ない件数を返すことがあります。

任意の公開動画で動作

エンドポイントは任意の公開動画の公開コメント欄を読み取ります。チャンネル所有権も OAuth 同意フローも不要。通常動画も Shorts も同じリクエスト構造で解決します。

予測可能なエラーコード

ドキュメント化されたステータスコードで失敗を処理します。400 は無効なリクエスト、401 はキーの不足または誤り、502/503/504 は一時的な上流の問題。各クラスは明確な修正または再試行アクションに対応します。

5 言語のサンプル

このページはエンドポイントの OpenAPI 定義から curl、JavaScript、Python、Java、Go のリクエスト例を直接生成します。スタックが使っている HTTP クライアントをそのまま採用できます。

使い方

次のステップで YouTube コメント検索 API を呼び出します。キーを作成し、GET リクエストを構築し、返されたコメントを処理します。

API キーを作成

AgentBody アカウントを作成し、コンソールで API キーを生成します。キーはサーバー環境または承認されたシークレットストアに保管し bearer トークンとして送信します。

GET リクエストを構築

必須の url クエリパラメータと任意の max_results（1〜50）を付けて GET /v1/youtube/comments を送信します。生成例は 5 つの言語での正確なリクエストを示します。

キーはサーバー側に

バックエンド、サーバーレス関数、定期ジョブからエンドポイントを呼びます。エンドユーザーが取得をトリガーする場合は独自エンドポイントでプロキシしてください。

JSON レスポンスをパース

コメントごとに id、author、text、like_count、reply_count を持つ items 配列と、video_id、total を読み取ります。テキストにそのままキーワード検索、感情分析、モデレーションフィルタを実行します。

必要なものを保存

製品が使うフィールドを永続化し、各行に video_id と取得時刻のタグを付けます。コメント欄は変化します。分析の基礎となったスナップショットを保存してください。

エラーを正しく処理

400 はリクエストを修正し、401 は有効なキーを設定します。502、503、504 はバックオフ付きで再試行してください。一時的な上流の状態であり、永続的な失敗ではありません。

よくある質問

YouTube コメント検索 API とは何ですか？

認証付き GET エンドポイント /v1/youtube/comments です。YouTube 動画の公開コメント欄を構造化 JSON として返します。項目は id、author、text、like_count、reply_count を持ち、video_id と total も付きます。1 回の呼び出しで 1 つの動画 URL です。

コメント API の料金はどうなっていますか？

各取得はアカウントのクレジットで実行されます。従量課金の価格はこのページの固定数値ではなくゲートウェイが管理します。コンソールで現在の費用を確認してください。

YouTube Data API との違いは？

OAuth 同意フローもクォータプロジェクトもチャンネルごとの API キー設定も不要——bearer キー 1 つ、URL パラメータ 1 つ、正規化されたコメント構造です。Google の完全なコメントツリー機能を、任意の公開動画で動く 1 回の呼び出しと引き換えます。

返されたコメントをキーワードや投稿者で検索できますか？

はい。レスポンスは構造化 JSON なので、コード内で items 配列に任意のキーワード、フレーズ、投稿者名フィルタを実行します。API はコメント欄を返し、マッチングのロジックはあなたのものです。柔軟性は製品が決めます。

トップレベルコメントに加えて返信も返りますか？

エンドポイントはトップレベルコメントを返し、各項目に返信数を示す reply_count フィールドが付きます。返信のテキストは現在のレスポンス構造には含まれません。reply_count はエンゲージメントシグナルとして扱ってください。

API エラーの処理方法は？

400 はリクエストを修正し、401 は bearer キーを修正します。502、503、504 は一時的な上流の障害としてバックオフ付きで再試行してください。ステータスコードをログに残し、パイプラインが不良リクエストと一時的な問題を区別できるようにします。