DataForSEO SERP YouTube Organic Live Advanced
From 2.4 credits/call
ae_dataforseo_serp_youtube_organic_live_advanced
Retrieve live organic YouTube search results for a specific keyword, location, and language using DataForSEO.
From 2.4 credits/call
Pricing
From 2.4 credits/call
| Condition | Charge |
|---|---|
| Each requested block of 20 parsing units | 2.4 credits |
Charges depend on the requested parsing 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[].device | string | null | No | No parameter description. | — |
tasks[].keyword | string | No | keyword required field you can specify up to 700 characters in the keyword field all %## will be decoded (plus character ‘+’ will be decoded to a space character) if you need to use the “%” character for your keyword, please specify it as “%25”; if you need to use the “+” character for your keyword, please specify it as “%2B”; learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article | — |
tasks[].block_depth | integer | null | No | No parameter description. | — |
tasks[].search_param | string | null | No | No parameter description. | — |
tasks[].language_code | string | null | No | No parameter description. | — |
tasks[].language_name | string | null | No | No parameter description. | — |
tasks[].location_code | integer | null | No | No parameter description. | — |
tasks[].location_name | string | null | No | No parameter description. | — |
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_organic_live_advanced' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tasks": [
{
"block_depth": 20,
"device": "desktop",
"keyword": "fútbol urbanito",
"language_code": "es",
"location_name": "Spain",
"search_param": "sp=EgQIBBAB",
"tag": "r2-182"
}
]
}
}'Response exampleresponse.json
{
"cost": 0.002,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.002,
"data": {
"api": "serp",
"block_depth": 20,
"device": "desktop",
"function": "live",
"keyword": "fútbol urbanito",
"language_code": "es"
},
"id": "11110755-2802-0139-0000-a48e9662b84d",
"path": [
"v3"
],
"result": [
{
"check_url": "https://www.youtube.com/results?search_query=f%C3%BAtbol%20urbanito&sp=EgQIBBAB",
"datetime": "2026-11-11 07:55:27 +00:00",
"item_types": [
"youtube_video"
],
"items": [
{}
],
"items_count": 3,
"keyword": "fútbol urbanito"
}
],
"result_count": 1
}
],
"tasks_count": 1,
"tasks_error": 0
}This example shows part of the response. Copied content is valid JSON.



