DataForSEO SERP YouTube Video Comments Live Advanced

From 2.4 credits/call
ae_dataforseo_serp_youtube_video_comments_live_advanced

Retrieve live comments from a specific YouTube video using DataForSEO, with options to filter by location, language, and device type.

SocialVideo
From 2.4 credits/call

Pricing

From 2.4 credits/call
ConditionCharge
Each requested depth block of 20 comments2.4 credits

Charges depend on the requested comment retrieval depth; partial blocks count as a full block.

The starting price applies to the first depth block. The default depth applies when omitted.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].osstring | nullNoNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].depthinteger | nullNoNo parameter description.—
tasks[].devicestring | nullNoNo parameter description.—
tasks[].video_idstringNo<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>—
tasks[].language_codestringNo<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—
tasks[].language_namestringNo<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>—
tasks[].location_codeintegerNo<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—
tasks[].location_namestringNo<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>—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_serp_youtube_video_comments_live_advanced' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "tasks": [
      {
        "depth": 40,
        "language_code": "en",
        "location_code": 2840,
        "video_id": "mlaTOq1KI8w"
      }
    ]
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cost": 0.004,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0.004,
      "data": {
        "api": "serp",
        "depth": 40,
        "device": "desktop",
        "function": "live",
        "language_code": "en",
        "location_code": 2840
      },
      "id": "11060940-2802-0139-0000-7f72b28c29d9",
      "path": [
        "v3"
      ],
      "result": [
        {
          "check_url": "https://www.youtube.com/watch?v=mlaTOq1KI8w",
          "comments_count": 6,
          "datetime": "2026-11-06 09:40:39 +00:00",
          "item_types": [
            "youtube_comment"
          ],
          "items": [
            {}
          ],
          "title": "ULTRAFORMER III HIFU Designing treatment area"
        }
      ],
      "result_count": 1
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

This example shows part of the response. Copied content is valid JSON.