YouTube Top Comments by Video ID (English)

omnial/youtube-comment-listing

Given a YouTube video ID, returns the video's title and total comment count and its top comments: each comment's text, the commenter's channel handle, how long ago it was posted, and its like and reply counts.

activeper callv1

Price

Up to $0.00273 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

YouTube

Data from YouTube.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/youtube-comment-listing" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/youtube-comment-listing" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/youtube-comment-listing", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/youtube-comment-listing", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.00273

Updated: Oct 15, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "video_id",
    "location_code",
    "language_code"
  ],
  "properties": {
    "depth": {
      "type": "integer",
      "default": 20,
      "maximum": 20,
      "minimum": 1,
      "description": "How many comments to collect, from 1 to 20 (one page); the supplier's default is 20."
    },
    "video_id": {
      "type": "string",
      "minLength": 1,
      "description": "The YouTube video ID, the code after v= in a watch link."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The language of the request; only en (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The country the request is made from; only 2840 (United States) is offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "text": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The comment text, with any links removed."
                },
                "author_name": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The commenter's channel handle."
                },
                "likes_count": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "The comment's like count."
                },
                "reply_count": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "How many replies the comment has."
                },
                "publication_date": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "How long ago the comment was posted, as shown (for example 2 months ago), with an edited marker where it applies."
                }
              }
            },
            "description": "The top comments, in the order the supplier returned them."
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "The video's title."
          },
          "datetime": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the comments were retrieved (UTC)."
          },
          "video_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "The video ID, as sent."
          },
          "items_count": {
            "type": [
              "number",
              "null"
            ],
            "description": "How many comments came back."
          },
          "comments_count": {
            "type": [
              "number",
              "null"
            ],
            "description": "The video's total comment count."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}