概要
YouTube動画の公開コメントは、視聴者が自分の言葉でどう反応し、どの発言に返信が集まり、クリエイターが応じているかを示します。このData Appは、1本の動画の公開コメント欄を、本文、投稿者、返信関係、反応のスナップショット、投稿時刻が揃ったデータセットにします。
手作業でコメント欄をスクロールするのではなく、繰り返し分析できる形で原文を残し、各コメントを動画・投稿者・親コメントに結び付けます。反応の比較、繰り返し現れるテーマの発見、会話の点検がしやすくなります。
データ説明
データは、指定したYouTube動画で取得時点に公開されているコメントを対象にします。レコードは投稿日時の新しい順です。通常レコードはコメントIDで識別され、重複除去にも使われます。非公開、削除済み、メンバー限定、コメント無効の動画は対象外です。
高評価数、返信数、低評価数、コメント数、チャンネル主、クリエイターハートは取得時点のスナップショットで、その後変わることがあります。件数やコメント種別・生のコメント種別などの区分値は数値化せずソースのテキストのままです。投稿日時、取得日時、整形日時はタイムゾーンを補わずソース表記を保ちます。相対時刻はページ表示のテキスト(例: 1年前)です。キーワード、ビジネスID、動画URL、ソース項目は、ソースレコードがそう持っている場合に投入した動画リンクを繰り返すことがあります。データなしは、公開コメントが取れなかったときの結果を残します。
結果の形
通常の各レコードは、選択したYouTube動画の公開コメント1件です。
| コメントID | コメント本文 | 投稿者ID | 投稿日時 | 高評価数 | 返信数 |
|---|---|---|---|---|---|
| UgwnKwe6YJKooQl-JaZ4AaABAg | 年紀漸長覺得這好像不錯 可以有大按鈕也不用佔螢幕空間 | @attacksoil | 2025-08-25T14:52:01 | 1 | 0 |
| UgwYMOjMzFk7w-8L0Fl4AaABAg | Good job DR RICK 👍 | @JoeGentry-g7k | 2025-08-27T15:03:26 | 0 | 0 |
ほかにアイコンやチャンネル情報、動画識別子、返信関係、クリエイターの反応、取得時刻、データなしの結果が含まれます。
利用シーン
- コメント本文を高評価数と返信数と見比べ、目に見える反応が強い発言を見つける。
- コメント本文を繰り返し現れる表現でまとめ、投稿日時で議論の変化を見る。
- 親コメントIDとコメント種別で返信スレッドを再構成し、トップレベルと返信を分ける。
- チャンネル主とクリエイターハートを投稿者IDと合わせて、チャンネル側の参加を見る。
適用範囲と境界
1回の実行で1本のYouTube動画からコメントを取得します。希望件数は1〜10000件です。結果は20件単位の完全なバッチで返るため、実際の件数は切り上げられる場合があります。対象は取得時点で公開されているコメントのみです。
- 適している用途
- 特定のYouTube動画の公開コメント本文と反応状況が必要なとき
- コメント投稿者、返信関係、投稿時刻、クリエイターの反応を分析したいとき
- 適さない用途
- 1回の実行で複数動画のコメントが必要なとき——動画ごとに別の実行を提出してください
- 非公開、削除済み、メンバー限定、コメント無効のデータを求めるとき——このAppは公開コメントのみを対象とします
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1コメントが返らない場合は、動画リンクを確認し、動画とコメントが公開されているか確かめてください
- 2レート制限、一時的な利用不可、タイムアウトのあとは、同じ内容で後から再試行できます
- 3提出結果が不明なときは、重複タスクを作らないよう、すぐ同じ内容を再提出しないでください
- 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| video_url | 動画リンク | string | はい | — | — | https://www.youtube.com/watch?v=mpUwmWy_tlg | コメントを取得する公開YouTube動画の完全な視聴URLです。1本の動画リンクのみを入力してください。リンクが無効、または動画にアクセスできない場合は結果が空になることがあります。 |
| comment_count | 希望コメント数 | integer | はい | — | 1–10000 | 20 | 取得したいコメント数で、1〜10000件です。結果は20件単位の完全なバッチで返され、同じ単位で課金されるため、実際の件数は切り上げられる場合があります。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| comment_id | コメントID | string | UgwnKwe6YJKooQl-JaZ4AaABAg | YouTubeコメントの安定した一意の識別子 |
| content_id | 動画ID | string | mpUwmWy_tlg | コメントが紐づくYouTube動画の識別子 |
| cur_id | レコードID | string | 6a8d3b9297884a4f18a27756 | このコメントとともに返されたソース側のレコード識別子 |
| comment_type | コメント種別 | string | 1 | コメント種別を示すソース値。ソースのテキストのまま保持されます |
| parent_comment_id | 親コメントID | string | — | 返信先の親コメント識別子。トップレベルコメントでは通常空です |
| comment_user_id | 投稿者ID | string | @attacksoil | コメント投稿者の公開YouTube識別子 |
| comment_user_avatar_url | 投稿者アイコン | string | https://yt3.ggpht.com/ytc/AIdro_nx14vEi8CIGWe-1TfJUlTVRCSMosevvM0iyj2yylc=s88-c-k-c0x00ffffff-no-rj | コメント投稿者の公開アイコン画像URL |
| comment_text | コメント本文 | string | 年紀漸長覺得這好像不錯 可以有大按鈕也不用佔螢幕空間 | YouTubeコメントとして公開された本文 |
| publish_time | 投稿日時 | string | 2025-08-25T14:52:01 | コメントが投稿されたソース側の時刻。データ源の表記のまま保持されます |
| crawl_time | 取得日時 | string | 2026-08-25T14:52:02 | このコメントレコードが取得されたソース側の時刻。データ源の表記のまま保持されます |
| like_count | 高評価数 | string | 1 | 取得時点の高評価数。ソースのテキストのまま保持されます |
| reply_count | 返信数 | string | 0 | 取得時点の返信数。ソースのテキストのまま保持されます |
| keyword | キーワード | string | https://www.youtube.com/watch?v=mpUwmWy_tlg | このコメントレコードに付随するキーワードまたはソース値。ソースのテキストのまま保持されます |
| root_content_url | 動画URL | string | https://www.youtube.com/watch?v=mpUwmWy_tlg | コメントが紐づくYouTube動画の完全なURL |
| channel_name | チャンネル名 | string | — | コメントが紐づく動画のチャンネル名 |
| comment_time | 相対時刻 | string | 1年前 | ページに表示される相対的な投稿時刻のテキスト |
| raw_comment_type | 生のコメント種別 | string | 0 | コメント種別を示す生のソース値。ソースのテキストのまま保持されます |
| dislike_count | 低評価数 | string | — | 取得時点の低評価数。ソースのテキストのまま保持されます |
| clean_update_time | 整形日時 | string | 2026-08-25T14:52:02 | このコメントレコードが整形または更新されたソース側の時刻。データ源の表記のまま保持されます |
| author_is_channel_owner | チャンネル主 | boolean | false | コメント投稿者がその動画のチャンネル主かどうか |
| comment_count | コメント数 | string | 4 | このレコードとともに返されたコメント数。ソースのテキストのまま保持されます |
| has_creator_heart | クリエイターハート | boolean | false | 動画のクリエイターがこのコメントにハートを付けたかどうか |
| biz_id | ビジネスID | string | https://www.youtube.com/watch?v=mpUwmWy_tlg | ソースのコメントレコードが持つビジネス識別子。ソースのテキストのまま保持されます |
| source_item | ソース項目 | string | https://www.youtube.com/watch?v=mpUwmWy_tlg | この結果レコードに対応する、投入されたYouTube動画URL |
| no_data | データなし | boolean | false | 対象動画について公開コメントが取得できなかったかどうか |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"type": "object",
"properties": {
"comment_id": {
"type": "string",
"title": "コメントID",
"description": "YouTubeコメントの安定した一意の識別子",
"prefill": "UgwnKwe6YJKooQl-JaZ4AaABAg"
},
"content_id": {
"type": "string",
"title": "動画ID",
"description": "コメントが紐づくYouTube動画の識別子",
"prefill": "mpUwmWy_tlg"
},
"cur_id": {
"type": "string",
"title": "レコードID",
"description": "このコメントとともに返されたソース側のレコード識別子",
"prefill": "6a8d3b9297884a4f18a27756"
},
"comment_type": {
"type": "string",
"title": "コメント種別",
"description": "コメント種別を示すソース値。ソースのテキストのまま保持されます",
"prefill": "1"
},
"parent_comment_id": {
"type": "string",
"title": "親コメントID",
"description": "返信先の親コメント識別子。トップレベルコメントでは通常空です"
},
"comment_user_id": {
"type": "string",
"title": "投稿者ID",
"description": "コメント投稿者の公開YouTube識別子",
"prefill": "@attacksoil"
},
"comment_user_avatar_url": {
"type": "string",
"title": "投稿者アイコン",
"description": "コメント投稿者の公開アイコン画像URL",
"prefill": "https://yt3.ggpht.com/ytc/AIdro_nx14vEi8CIGWe-1TfJUlTVRCSMosevvM0iyj2yylc=s88-c-k-c0x00ffffff-no-rj"
},
"comment_text": {
"type": "string",
"title": "コメント本文",
"description": "YouTubeコメントとして公開された本文",
"prefill": "年紀漸長覺得這好像不錯 可以有大按鈕也不用佔螢幕空間"
},
"publish_time": {
"type": "string",
"title": "投稿日時",
"description": "コメントが投稿されたソース側の時刻。データ源の表記のまま保持されます",
"prefill": "2025-08-25T14:52:01"
},
"crawl_time": {
"type": "string",
"title": "取得日時",
"description": "このコメントレコードが取得されたソース側の時刻。データ源の表記のまま保持されます",
"prefill": "2026-08-25T14:52:02"
},
"like_count": {
"type": "string",
"title": "高評価数",
"description": "取得時点の高評価数。ソースのテキストのまま保持されます",
"prefill": "1"
},
"reply_count": {
"type": "string",
"title": "返信数",
"description": "取得時点の返信数。ソースのテキストのまま保持されます",
"prefill": "0"
},
"keyword": {
"type": "string",
"title": "キーワード",
"description": "このコメントレコードに付随するキーワードまたはソース値。ソースのテキストのまま保持されます",
"prefill": "https://www.youtube.com/watch?v=mpUwmWy_tlg"
},
"root_content_url": {
"type": "string",
"title": "動画URL",
"description": "コメントが紐づくYouTube動画の完全なURL",
"prefill": "https://www.youtube.com/watch?v=mpUwmWy_tlg"
},
"channel_name": {
"type": "string",
"title": "チャンネル名",
"description": "コメントが紐づく動画のチャンネル名"
},
"comment_time": {
"type": "string",
"title": "相対時刻",
"description": "ページに表示される相対的な投稿時刻のテキスト",
"prefill": "1年前"
},
"raw_comment_type": {
"type": "string",
"title": "生のコメント種別",
"description": "コメント種別を示す生のソース値。ソースのテキストのまま保持されます",
"prefill": "0"
},
"dislike_count": {
"type": "string",
"title": "低評価数",
"description": "取得時点の低評価数。ソースのテキストのまま保持されます"
},
"clean_update_time": {
"type": "string",
"title": "整形日時",
"description": "このコメントレコードが整形または更新されたソース側の時刻。データ源の表記のまま保持されます",
"prefill": "2026-08-25T14:52:02"
},
"author_is_channel_owner": {
"type": "boolean",
"title": "チャンネル主",
"description": "コメント投稿者がその動画のチャンネル主かどうか",
"prefill": false
},
"comment_count": {
"type": "string",
"title": "コメント数",
"description": "このレコードとともに返されたコメント数。ソースのテキストのまま保持されます",
"prefill": "4"
},
"has_creator_heart": {
"type": "boolean",
"title": "クリエイターハート",
"description": "動画のクリエイターがこのコメントにハートを付けたかどうか",
"prefill": false
},
"biz_id": {
"type": "string",
"title": "ビジネスID",
"description": "ソースのコメントレコードが持つビジネス識別子。ソースのテキストのまま保持されます",
"prefill": "https://www.youtube.com/watch?v=mpUwmWy_tlg"
},
"source_item": {
"type": "string",
"title": "ソース項目",
"description": "この結果レコードに対応する、投入されたYouTube動画URL",
"prefill": "https://www.youtube.com/watch?v=mpUwmWy_tlg"
},
"no_data": {
"type": "boolean",
"title": "データなし",
"description": "対象動画について公開コメントが取得できなかったかどうか",
"prefill": false
}
},
"required": [],
"additionalProperties": false
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。
MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"hello_moto__youtube-video-comments": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/youtube-video-comments",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。