Skip to main content
Glama

AIsa SERP — Other Engines

Live YouTube Comments Advanced

post_dataforseo_serp_youtube_video_comments_live
Destructive

‌ Live YouTube Comments provides real-time data on comments on the video you specify in the request. You will get the top 20 comments on the video as well as information about the author, and key comment metrics.

Usage-based billing; Default request estimate: $0.004 USD (not a fixed price). Account-specific pricing and final settlement may differ.

Input Schema

NameRequiredDescriptionDefault
bodyNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / body / items / oneOf
      Previous value: -[
      -  {
      -    "example": [
      -      {
      -        "language_code": "en",
      -        "location_code": 2840,
      -        "video_id": "vQXvyV0zIP4"
      -      }
      -    ],
      -    "properties": {
      -      "depth": {
      -        "description": "<em>parsing depth</em><br>optional field<br>number of results in SERP<br>default value: <code>20</code><br>max value: <code>200</code><br><strong>Note:</strong> your account will be billed per each SERP containing up to 20 results;<br>thus, setting a depth above <code>20</code> may result in additional charges if the search engine returns more than 20 results;<br>if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "device": {
      -        "description": "<em>device type</em><br>optional field<br>only value: <code>desktop</code>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "language_code": {
      -        "description": "<em>search engine language code</em><br><strong>required field if you don't specify</strong> <code>language_name</code><br><strong>if you use this field, you don't need to specify <code>language_name</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_code</code>_by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><em><br></em>example:<em><br></em><code class=\"long-string\">en</code>n",
      -        "type": "string"
      -      },
      -      "language_name": {
      -        "description": "<em>full name of search engine language</em><br><strong>required field if you don't specify</strong> <code>language_code</code><br><strong>if you use this field, you don't need to specify <code>language_code</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><br>example:<br><code class=\"long-string\">English</code>",
      -        "type": "string"
      -      },
      -      "location_code": {
      -        "description": "<em>search engine location code</em><br><strong>required field if you don't specify</strong> <code>location_name</code>_<br><strong>if you use this field, you don't need to specify <code>location_name</code></strong><br>you can receive the list of available locations of the search engines with their <code>location_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">2840</code>n",
      -        "type": "integer"
      -      },
      -      "location_name": {
      -        "description": "<em>full name of search engine location</em><br><strong>required field if you don't specify</strong> <code>location_code</code><br><strong>if you use this field, you don't need to specify <code>location_code</code></strong><br>you can receive the list of available locations of the search engine with their <code>location_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">United States</code>",
      -        "type": "string"
      -      },
      -      "os": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tag": {
      -        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "video_id": {
      -        "description": "<em>ID of the video</em><br><strong>required field</strong><br>you can find video ID in the URL or 'youtube_video' item of <a href=\"/v3/serp/youtube/organic/live/advanced/\" rel=\"noopener noreferrer\" target=\"_blank\">YouTube Organic</a> result<br>example:<br><code>vQXvyV0zIP4</code>",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "depth": {
      +        "description": "<em>parsing depth</em><br>optional field<br>number of results in SERP<br>default value: <code>20</code><br>max value: <code>200</code><br><strong>Note:</strong> your account will be billed per each SERP containing up to 20 results;<br>thus, setting a depth above <code>20</code> may result in additional charges if the search engine returns more than 20 results;<br>if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "device": {
      +        "description": "<em>device type</em><br>optional field<br>only value: <code>desktop</code>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_code": {
      +        "description": "<em>search engine language code</em><br><strong>required field if you don't specify</strong> <code>language_name</code><br><strong>if you use this field, you don't need to specify <code>language_name</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_code</code>_by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><em><br></em>example:<em><br></em><code class=\"long-string\">en</code>n",
      +        "type": "string"
      +      },
      +      "language_name": {
      +        "description": "<em>full name of search engine language</em><br><strong>required field if you don't specify</strong> <code>language_code</code><br><strong>if you use this field, you don't need to specify <code>language_code</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><br>example:<br><code class=\"long-string\">English</code>",
      +        "type": "string"
      +      },
      +      "location_code": {
      +        "description": "<em>search engine location code</em><br><strong>required field if you don't specify</strong> <code>location_name</code>_<br><strong>if you use this field, you don't need to specify <code>location_name</code></strong><br>you can receive the list of available locations of the search engines with their <code>location_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">2840</code>n",
      +        "type": "integer"
      +      },
      +      "location_name": {
      +        "description": "<em>full name of search engine location</em><br><strong>required field if you don't specify</strong> <code>location_code</code><br><strong>if you use this field, you don't need to specify <code>location_code</code></strong><br>you can receive the list of available locations of the search engine with their <code>location_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">United States</code>",
      +        "type": "string"
      +      },
      +      "os": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tag": {
      +        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "video_id": {
      +        "description": "<em>ID of the video</em><br><strong>required field</strong><br>you can find video ID in the URL or 'youtube_video' item of <a href=\"/v3/serp/youtube/organic/live/advanced/\" rel=\"noopener noreferrer\" target=\"_blank\">YouTube Organic</a> result<br>example:<br><code>vQXvyV0zIP4</code>",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
  2. Changed2 schema fields changed
    • removedInput schema / properties / body / items / anyOf
      Removed value: -[
      -  {
      -    "example": [
      -      {
      -        "language_code": "en",
      -        "location_code": 2840,
      -        "video_id": "vQXvyV0zIP4"
      -      }
      -    ],
      -    "properties": {
      -      "depth": {
      -        "description": "<em>parsing depth</em><br>optional field<br>number of results in SERP<br>default value: <code>20</code><br>max value: <code>200</code><br><strong>Note:</strong> your account will be billed per each SERP containing up to 20 results;<br>thus, setting a depth above <code>20</code> may result in additional charges if the search engine returns more than 20 results;<br>if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance",
      -        "type": [
      -          "integer",
      -          "null"
      -        ]
      -      },
      -      "device": {
      -        "description": "<em>device type</em><br>optional field<br>only value: <code>desktop</code>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "language_code": {
      -        "description": "<em>search engine language code</em><br><strong>required field if you don't specify</strong> <code>language_name</code><br><strong>if you use this field, you don't need to specify <code>language_name</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_code</code>_by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><em><br></em>example:<em><br></em><code class=\"long-string\">en</code>n",
      -        "type": "string"
      -      },
      -      "language_name": {
      -        "description": "<em>full name of search engine language</em><br><strong>required field if you don't specify</strong> <code>language_code</code><br><strong>if you use this field, you don't need to specify <code>language_code</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><br>example:<br><code class=\"long-string\">English</code>",
      -        "type": "string"
      -      },
      -      "location_code": {
      -        "description": "<em>search engine location code</em><br><strong>required field if you don't specify</strong> <code>location_name</code>_<br><strong>if you use this field, you don't need to specify <code>location_name</code></strong><br>you can receive the list of available locations of the search engines with their <code>location_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">2840</code>n",
      -        "type": "integer"
      -      },
      -      "location_name": {
      -        "description": "<em>full name of search engine location</em><br><strong>required field if you don't specify</strong> <code>location_code</code><br><strong>if you use this field, you don't need to specify <code>location_code</code></strong><br>you can receive the list of available locations of the search engine with their <code>location_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">United States</code>",
      -        "type": "string"
      -      },
      -      "os": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tag": {
      -        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "video_id": {
      -        "description": "<em>ID of the video</em><br><strong>required field</strong><br>you can find video ID in the URL or 'youtube_video' item of <a href=\"/v3/serp/youtube/organic/live/advanced/\" rel=\"noopener noreferrer\" target=\"_blank\">YouTube Organic</a> result<br>example:<br><code>vQXvyV0zIP4</code>",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]
    • addedInput schema / properties / body / items / oneOf
      Added value: +[
      +  {
      +    "example": [
      +      {
      +        "language_code": "en",
      +        "location_code": 2840,
      +        "video_id": "vQXvyV0zIP4"
      +      }
      +    ],
      +    "properties": {
      +      "depth": {
      +        "description": "<em>parsing depth</em><br>optional field<br>number of results in SERP<br>default value: <code>20</code><br>max value: <code>200</code><br><strong>Note:</strong> your account will be billed per each SERP containing up to 20 results;<br>thus, setting a depth above <code>20</code> may result in additional charges if the search engine returns more than 20 results;<br>if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "device": {
      +        "description": "<em>device type</em><br>optional field<br>only value: <code>desktop</code>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_code": {
      +        "description": "<em>search engine language code</em><br><strong>required field if you don't specify</strong> <code>language_name</code><br><strong>if you use this field, you don't need to specify <code>language_name</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_code</code>_by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><em><br></em>example:<em><br></em><code class=\"long-string\">en</code>n",
      +        "type": "string"
      +      },
      +      "language_name": {
      +        "description": "<em>full name of search engine language</em><br><strong>required field if you don't specify</strong> <code>language_code</code><br><strong>if you use this field, you don't need to specify <code>language_code</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><br>example:<br><code class=\"long-string\">English</code>",
      +        "type": "string"
      +      },
      +      "location_code": {
      +        "description": "<em>search engine location code</em><br><strong>required field if you don't specify</strong> <code>location_name</code>_<br><strong>if you use this field, you don't need to specify <code>location_name</code></strong><br>you can receive the list of available locations of the search engines with their <code>location_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">2840</code>n",
      +        "type": "integer"
      +      },
      +      "location_name": {
      +        "description": "<em>full name of search engine location</em><br><strong>required field if you don't specify</strong> <code>location_code</code><br><strong>if you use this field, you don't need to specify <code>location_code</code></strong><br>you can receive the list of available locations of the search engine with their <code>location_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">United States</code>",
      +        "type": "string"
      +      },
      +      "os": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tag": {
      +        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "video_id": {
      +        "description": "<em>ID of the video</em><br><strong>required field</strong><br>you can find video ID in the URL or 'youtube_video' item of <a href=\"/v3/serp/youtube/organic/live/advanced/\" rel=\"noopener noreferrer\" target=\"_blank\">YouTube Organic</a> result<br>example:<br><code>vQXvyV0zIP4</code>",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
  3. Changed8 schema fields changed
    • addedInput schema / properties / body / example
      Added value: +[
      +  {
      +    "language_code": "en",
      +    "location_code": 2840,
      +    "video_id": "vQXvyV0zIP4"
      +  }
      +]
    • removedInput schema / properties / body / items / allOf
      Removed value: -[
      -  {
      -    "anyOf": [
      -      {
      -        "required": [
      -          "location_code"
      -        ]
      -      },
      -      {
      -        "required": [
      -          "location_name"
      -        ]
      -      }
      -    ]
      -  },
      -  {
      -    "anyOf": [
      -      {
      -        "required": [
      -          "language_code"
      -        ]
      -      },
      -      {
      -        "required": [
      -          "language_name"
      -        ]
      -      }
      -    ]
      -  }
      -]
    • addedInput schema / properties / body / items / anyOf
      Added value: +[
      +  {
      +    "example": [
      +      {
      +        "language_code": "en",
      +        "location_code": 2840,
      +        "video_id": "vQXvyV0zIP4"
      +      }
      +    ],
      +    "properties": {
      +      "depth": {
      +        "description": "<em>parsing depth</em><br>optional field<br>number of results in SERP<br>default value: <code>20</code><br>max value: <code>200</code><br><strong>Note:</strong> your account will be billed per each SERP containing up to 20 results;<br>thus, setting a depth above <code>20</code> may result in additional charges if the search engine returns more than 20 results;<br>if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance",
      +        "type": [
      +          "integer",
      +          "null"
      +        ]
      +      },
      +      "device": {
      +        "description": "<em>device type</em><br>optional field<br>only value: <code>desktop</code>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_code": {
      +        "description": "<em>search engine language code</em><br><strong>required field if you don't specify</strong> <code>language_name</code><br><strong>if you use this field, you don't need to specify <code>language_name</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_code</code>_by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><em><br></em>example:<em><br></em><code class=\"long-string\">en</code>n",
      +        "type": "string"
      +      },
      +      "language_name": {
      +        "description": "<em>full name of search engine language</em><br><strong>required field if you don't specify</strong> <code>language_code</code><br><strong>if you use this field, you don't need to specify <code>language_code</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/languages</code><br>example:<br><code class=\"long-string\">English</code>",
      +        "type": "string"
      +      },
      +      "location_code": {
      +        "description": "<em>search engine location code</em><br><strong>required field if you don't specify</strong> <code>location_name</code>_<br><strong>if you use this field, you don't need to specify <code>location_name</code></strong><br>you can receive the list of available locations of the search engines with their <code>location_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">2840</code>n",
      +        "type": "integer"
      +      },
      +      "location_name": {
      +        "description": "<em>full name of search engine location</em><br><strong>required field if you don't specify</strong> <code>location_code</code><br><strong>if you use this field, you don't need to specify <code>location_code</code></strong><br>you can receive the list of available locations of the search engine with their <code>location_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/youtube/locations</code><br>example:<br><code class=\"long-string\">United States</code>",
      +        "type": "string"
      +      },
      +      "os": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tag": {
      +        "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "video_id": {
      +        "description": "<em>ID of the video</em><br><strong>required field</strong><br>you can find video ID in the URL or 'youtube_video' item of <a href=\"/v3/serp/youtube/organic/live/advanced/\" rel=\"noopener noreferrer\" target=\"_blank\">YouTube Organic</a> result<br>example:<br><code>vQXvyV0zIP4</code>",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / body / items / properties
      Removed value: -{
      -  "language_code": {
      -    "description": "search engine language code required field if you don't specify language_name if you use this field, you don't need to specify language_name you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages example: enn",
      -    "type": "string"
      -  },
      -  "language_name": {
      -    "description": "full name of search engine language required field if you don't specify language_code if you use this field, you don't need to specify language_code you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages example: English",
      -    "type": "string"
      -  },
      -  "location_code": {
      -    "description": "search engine location code required field if you don't specify location_name_ if you use this field, you don't need to specify location_name you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations example: 2840n",
      -    "type": "integer"
      -  },
      -  "location_name": {
      -    "description": "full name of search engine location required field if you don't specify location_code if you use this field, you don't need to specify location_code you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations example: United States",
      -    "type": "string"
      -  },
      -  "video_id": {
      -    "description": "ID of the video required field you can find video ID in the URL or 'youtube_video' item of YouTube Organic result example: vQXvyV0zIP4",
      -    "type": "string"
      -  }
      -}
    • removedInput schema / properties / body / items / required
      Removed value: -[
      -  "video_id"
      -]
    • changedInput schema / properties / body / items / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / required
      Previous value: -[
      -  "body"
      -]New value: +[]
    • addedOutput schema / x-fastmcp-wrap-result
      Added value: +true
  4. Changed5 schema fields changed
    • changedInput schema / properties / body / items / properties / language_code / description
      Previous value: -"YouTube interface language code, for example en. Provide this or language_name."New value: +"search engine language code required field if you don't specify language_name if you use this field, you don't need to specify language_name you can receive the list of available languages of the search engine with their language_code_by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages example: enn"
    • changedInput schema / properties / body / items / properties / language_name / description
      Previous value: -"YouTube interface language name, for example English. Provide this or language_code."New value: +"full name of search engine language required field if you don't specify language_code if you use this field, you don't need to specify language_code you can receive the list of available languages of the search engine with their language_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/languages example: English"
    • changedInput schema / properties / body / items / properties / location_code / description
      Previous value: -"YouTube location code, for example 2840. Provide this or location_name."New value: +"search engine location code required field if you don't specify location_name_ if you use this field, you don't need to specify location_name you can receive the list of available locations of the search engines with their location_code by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations example: 2840n"
    • changedInput schema / properties / body / items / properties / location_name / description
      Previous value: -"YouTube location name, for example United States. Provide this or location_code."New value: +"full name of search engine location required field if you don't specify location_code if you use this field, you don't need to specify location_code you can receive the list of available locations of the search engine with their location_name by making a separate request to the https://api.dataforseo.com/v3/serp/youtube/locations example: United States"
    • changedInput schema / properties / body / items / properties / video_id / description
      Previous value: -"ID of the video"New value: +"ID of the video required field you can find video ID in the URL or 'youtube_video' item of YouTube Organic result example: vQXvyV0zIP4"
  5. First observed

TDQS

C2.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare openWorld/destructive/non-idempotent, so the safety profile is covered; the description's real contribution is the billing disclosure ('usage-based, default estimate $0.004'). However it omits the notable behaviors: the request is submitted as a body array (batched tasks), and depth above 20 incurs additional charges — a cost-side effect only the schema mentions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in one clear sentence, but the definition carries a stray leading invisible character and a templated pricing block with HTML comments. The pricing line does earn some place by disclosing cost, yet the packaging is boilerplate rather than tailored.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The schema declares zero required top-level parameters, yet video_id is required inside the body — the description never states this, so an agent could issue an empty, invalid, or uncharged-but-failing request. An output schema exists so return values need no explanation, but the invocation contract (task-array wrapper, mandatory video_id, paired language/location fields) is left undocumented.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is reported at 0% for the top-level `body` parameter, so the description is expected to compensate and does not. It never explains the array-of-task-objects wrapper, and it mentions only the video implicitly while ignoring language/location/depth/os/tag semantics; the inherited schema docs are the only guidance (and note depth is capped at 200, contradicting the 'top 20' claim).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource: real-time comments on a specified YouTube video, plus what comes back (top 20 comments, author info, comment metrics). It does not distinguish itself from close siblings such as post_dataforseo_serp_youtube_video_info_live or _video_subtitles_live, so the agent must infer the boundary from the name alone.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No when-to-use / when-not-to-use guidance and no named alternatives, despite three closely related YouTube siblings. The only usage signal ('the video you specify') is an implicit requirement, not a selection rule.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources