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.
From 2.4 credits/call
Pricing
From 2.4 credits/call
| Condition | Charge |
|---|---|
| Each requested depth block of 20 comments | 2.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
tasks | array | Yes | No parameter description. | — |
tasks[].os | string | null | No | No parameter description. | — |
tasks[].tag | string | null | No | No parameter description. | — |
tasks[].depth | integer | null | No | No parameter description. | — |
tasks[].device | string | null | No | No parameter description. | — |
tasks[].video_id | string | No | <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_code | string | No | <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_name | string | No | <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_code | integer | No | <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_name | string | No | <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-KeyRequest 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
{
"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.




