List YouTube search results for a keyword API

One call returns up to 29 YouTube search results for a keyword. Each item is a video with title, channel, view count, duration, and publication date. The answer contained 29 items with no pagination shown.

1 live route on DataForSEO, from $0.002 per call. Every route below answered our last live test on 2026-10-06; the gateway re-tests them daily.

Get a key See it in the catalog Use it from MCP

Price per call, by route

The upstream price you are metered at, cheapest first. A route without a published price says so.

Provider	Endpoint	Price	Tested
DataForSEO	YouTube search results`POST serp/youtube/organic/live/advanced`	$0.002$2.00 / 1k calls	✓ 2026-10-06pricing ↗

What it returns

From a real call to the route: DataForSEO.

tasks[].result[].items[].titleVideo titletasks[].result[].items[].urlVideo URLtasks[].result[].items[].video_idYouTube video IDtasks[].result[].items[].channel_nameChannel nametasks[].result[].items[].channel_idYouTube channel IDtasks[].result[].items[].channel_urlChannel URLtasks[].result[].items[].views_countTotal video viewstasks[].result[].items[].duration_time_secondsVideo length in secondstasks[].result[].items[].publication_dateRelative publish timetasks[].result[].items[].is_shortsWhether video is a YouTube Short

Call it

HTTP with your key in x-api-key, or the call_endpoint tool of our MCP server.

POST /api/gw/dataforseo/serp/youtube/organic/live/advanced$0.002 / call✓ working · tested 2026-10-065.06 s latency

Parameters

Parameter	Type		Notes
keyword	str · body	JSON body field	e.g. `"mr beast"`
language_code	str · body	JSON body field	e.g. `"en"`
location_code	int · body	JSON body field	e.g. `2840`

HTTP

curl -X POST "https://fetchapi.co/api/gw/dataforseo/serp/youtube/organic/live/advanced" \
  -H "x-api-key: YOUR_KEY" -H "content-type: application/json" \
  -d '[{"keyword": "mr beast", "language_code": "en", "location_code": 2840}]'

MCP

call_endpoint("dataforseo.serp_youtube_organic", {}, [{"keyword": "mr beast", "language_code": "en", "location_code": 2840}])

Real example answer (trimmed) · 2026-10-04

{
  "cost": 0.002,
  "time": "4.9529 sec.",
  "tasks": [
    {
      "id": "10040442-2697-0139-0000-d0ad3ea9d933",
      "cost": 0.002,
      "data": {
        "os": "windows",
        "se": "youtube",
        "api": "serp",
        "device": "desktop",
        "keyword": "mr beast",
        "se_type": "organic",
        "function": "live",
        "language_code": "en",
        "location_code": 2840
      },
      "path": [
        "v3",
        "serp",
        "… 2 more"
      ],
      "time": "4.8365 sec.",
      "result": [
        {
          "items": [
            {
              "url": "…",
              "type": "…",
              "title": "…",
              "badges": "…",
              "is_live": "…",
              "is_movie": "…",
              "video_id": "…",
              "is_shorts": "…",
              "timestamp": "…",
              "block_name": "…",
              "block_rank": "…",
              "channel_id": "…",
              "rank_group": "…",
              "channel_url": "…",
              "…": "10 more fields"
            },
            {
              "url": "…",
              "type": "…",
              "title": "…",
              "badges": "…",
              "is_live": "…",
              "is_movie": "…",
              "video_id": "…",
              "is_shorts": "…",
              "timestamp": "…",
              "block_name": "…",
              "block_rank": "…",
              "channel_id": "…",
              "rank_group": "…",
              "channel_url": "…",
              "…": "10 more fields"
            },
            "… 2 more"
          ],
          "spell": null,
          "keyword": "mr beast",
          "datetime": "2026-10-04 04:42:11 +00:00",
          "check_url": "https://www.youtube.com/results?search_query=mr%20beast",
          "se_domain": "youtube.com",
          "item_types": [
            "youtube_video"
          ],
          "items_count": 29,
          "language_code": "en",
          "location_code": 2840,
          "se_results_count": 12560153
        }
      ],
      "status_code": 20000,
      "result_count": 1,
      "status_message": "Ok."
    }
  ],
  "version": "0.1.20260917",
  "status_code": 20000,
  "tasks_count": 1,
  "tasks_error": 0,
  "status_message": "Ok."
}

Related DataForSEO APIs

All 20 DataForSEO jobs →

Get Google autocomplete suggestions for a keywordfrom $0.002
Get Google's AI-generated answer for a keywordfrom $0.004
List Amazon keywords a product ranks forfrom $0.01224
List Bing organic search results for a keywordfrom $0.002
List Google News results for a keywordfrom $0.002
List Google organic search results for a keywordfrom $0.002
List mentions of a domain in AI answersfrom $0.11
Search web pages mentioning a keywordfrom $0.00012

One key for every API on this page.

Call it over HTTP or from any MCP client. Each key has a rate limit and a monthly cap; calls are metered at the upstream price.

Get a key Set up MCP Browse the catalog