YouTube Search API

The YouTube Search API lets you scrape YouTube search results for any query. Returns structured video data including titles, links, channel info, view counts, durations, thumbnails, and pagination tokens. Each successful request costs 5 API credits.

Endpoint: https://api.scrapingdog.com/youtube

API Parameters

🔑

Scrapingdog Parameters

api_key Required
Your personal API key. Available on your dashboard.

Type: String

🔍

Search Query

search_query Required
This can be any YouTube query. Example: search_query=elon+musk

Type: String

🌍

Geographic Location and Localization

country Optional
ISO code of the country from which you are seeking YouTube search results. Default: us

Type: String
language Optional
Language of the results. Possible Values — en, es, fr, de, etc. Default: en

Type: String

⚙

️ Advanced

sp Optional
Used for pagination and filtering search results on YouTube. Supports upload date (CAI%3D), 4K videos (EgJwAQ%3D%3D), exact spelling (QgIIAQ%3D%3D), and custom filters. Also used as next_page_token from the previous response for pagination.

Type: String

API Examples

Code to Integrate

curl "https://api.scrapingdog.com/youtube?api_key=APIKEY&search_query=elon+musk"

import requests

params = {
    "api_key": "APIKEY",
    "search_query": "elon musk",
    "country": "us",
    "language": "en"
}

response = requests.get("https://api.scrapingdog.com/youtube", params=params)
print(response.json())

const params = new URLSearchParams({
  api_key: "APIKEY",
  search_query: "elon musk",
  country: "us",
  language: "en"
});

const res = await fetch(`https://api.scrapingdog.com/youtube?${params}`);
const data = await res.json();
console.log(data);

<?php
$url = 'https://api.scrapingdog.com/youtube?' . http_build_query([
    'api_key'      => 'APIKEY',
    'search_query' => 'elon musk',
    'country'      => 'us',
    'language'     => 'en',
]);
echo file_get_contents($url);

API Response

{
  "channel_results": [
    {
      "title": "Scrapingdog",
      "link": "https://www.youtube.com/@scrapingdog9955",
      "verified": false,
      "handle": "@scrapingdog9955",
      "subscribers": 372,
      "description": "",
      "thumbnail": "https://yt3.ggpht.com/...",
      "position": 1
    }
  ],
  "video_results": [
    {
      "title": "What is Scrapingdog | Introduction Video | How To Use Scrapingdog API",
      "link": "https://www.youtube.com/watch?v=GOxYIfnvB-w",
      "channel": {
        "name": "Scrapingdog",
        "link": "https://www.youtube.com/channel/@scrapingdog9955",
        "thumbmail": "https://yt3.ggpht.com/...",
        "verified": false
      },
      "published_date": "1 year ago",
      "views": "4,193 views",
      "length": "2:27",
      "description": "Hey there! ...",
      "extensions": [],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/GOxYIfnvB-w/hq720.jpg",
        "rich": ""
      },
      "position": 3
    }
  ],
  "shorts_results": [
    {
      "shorts": [
        {
          "title": "Stop Fighting CAPTCHAs. Do This Instead",
          "link": "https://www.youtube.com//shorts/fqIWBxH1pko",
          "thumbnail": "https://i.ytimg.com/vi/fqIWBxH1pko/frame0.jpg",
          "views_original": "547",
          "views": 547,
          "video_id": "",
          "position": 1
        }
      ],
      "position": 2
    }
  ],
  "movie_results": [],
  "pagination": {
    "current": "https://www.youtube.com/results?search_query=scrapingdog",
    "next_page_token": "SBSCARhVQy1OVzd6...",
    "next": "https://www.youtube.com/results?search_query=scrapingdog&sp=SBSCARhVQy1OVzd6..."
  }
}