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.

Video
From 2.4 credits/call

Pricing

From 2.4 credits/call
ConditionCharge
Each requested block of 20 parsing units2.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.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].osstring | nullNoNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].devicestring | nullNoNo parameter description.—
tasks[].keywordstringNokeyword 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_depthinteger | nullNoNo parameter description.—
tasks[].search_paramstring | nullNoNo parameter description.—
tasks[].language_codestring | nullNoNo parameter description.—
tasks[].language_namestring | nullNoNo parameter description.—
tasks[].location_codeinteger | nullNoNo parameter description.—
tasks[].location_namestring | nullNoNo parameter description.—

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_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
JSONPartial content
{
  "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.