YouTube Video Results API

These are the main YouTube "organic" video results. When SerpApi encounters this type of results, we add them to our JSON output as the array video_results. For each video result, we are able to extract its position_on_page, title, link, channel, published_date, views, length, thumbnail and more.

API Examples

Playlist results overview

Playlist results overview

JSON Example

{
  ...
  "video_results": [
    ...
    {
      "position_on_page": 10,
      "title": "BOBA FETT IS OFFICIALLY BACK, CAPTAIN REX ENDING! - Mandalorian S2 EP1 Explained",
      "link": "https://www.youtube.com/watch?v=4uhaMCaZOiY",
      "serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=4uhaMCaZOiY",
      "channel": {
        "name": "Star Wars Comics",
        "link": "https://www.youtube.com/user/BesY24",
        "verified": true,
        "thumbnail": "https://yt3.ggpht.com/a-/AOh14GgRxHciuEwu6q3DqPomfS9wIzQLXyMnnkclUg=s68-c-k-c0x00ffffff-no-rj-mo"
      },
      "published_date": "20 hours ago",
      "views": 82216,
      "length": "11:25",
      "description": "HE IS BACK, The Mandalorian Season 2 Episode 1 Review is here and we talk about no only Baby Yoda and Mando but the ...",
      "extensions": [
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/4uhaMCaZOiY/hq720.jpg?sqp=-oaymwEZCOgCEMoBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLDnIbp5F2PGsxHyUC8KlP4Ghm5DFQ",
        "rich": "https://i.ytimg.com/an_webp/4uhaMCaZOiY/mqdefault_6s.webp?du=3000&sqp=CJby9PwF&rs=AOn4CLDY8NHADZolp-fnsv1DCAfuYUA_Eg"
      }
    },
    {
      "position_on_page": 11,
      "title": "2020 Portrayed by Star Wars",
      "link": "https://www.youtube.com/watch?v=L8Sezzl7_zU",
      "serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=L8Sezzl7_zU",
      "channel": {
        "name": "Supercuts Delight",
        "link": "https://www.youtube.com/channel/UCg_s1VNrLoV4cFsH9TKXnuw",
        "thumbnail": "https://yt3.ggpht.com/a-/AOh14GhpsylVb0S_fngM7KPSLXTsrSPIMdLMn3JEyA=s68-c-k-c0x00ffffff-no-rj-mo"
      },
      "published_date": "1 month ago",
      "views": 1488270,
      "length": "7:04",
      "description": "A Parody of Star Wars in which I relate events that have happened in 2020 to scenes and clips from Star Wars. Basically a recap ...",
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/L8Sezzl7_zU/hq720.jpg?sqp=-oaymwEZCOgCEMoBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLB1L30hsaHnNpdPrDpEQ31VVwnW4w",
        "rich": "https://i.ytimg.com/an_webp/L8Sezzl7_zU/mqdefault_6s.webp?du=3000&sqp=CMzk9PwF&rs=AOn4CLCOipXxYpZjKuyaNVpBvEToV8tFdQ"
      }
    },
    {
      "position_on_page": 12,
      "title": "STAR WARS THE OLD REPUBLIC Full Movie Cinematic 4K ULTRA HD All Cinematics Trailers",
      "link": "https://www.youtube.com/watch?v=DCboJ2GizmM",
      "serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=DCboJ2GizmM",
      "channel": {
        "name": "GameClips",
        "link": "https://www.youtube.com/user/MKIceVsFire",
        "thumbnail": "https://yt3.ggpht.com/a-/AOh14GiaoOuDpAhg9nn5u1XnzTWaKzFbKbFvoc7UuA=s68-c-k-c0x00ffffff-no-rj-mo"
      },
      "published_date": "2 months ago",
      "views": 2060231,
      "length": "23:20",
      "description": "STAR WARS THE OLD REPUBLIC Full Movie Cinematic 4K ULTRA HD All Cinematics Trailers Protected by the legendary Jedi ...",
      "extensions": [
        "4K"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/DCboJ2GizmM/hq720.jpg?sqp=-oaymwEZCOgCEMoBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLDkMCAaUzMhPRBwHP1np7QHGTtOzA",
        "rich": "https://i.ytimg.com/an_webp/DCboJ2GizmM/mqdefault_6s.webp?du=3000&sqp=CJyO9fwF&rs=AOn4CLAnoaxqwOcQPj2L9ehUC87mgASLCA"
      }
    },
    ...
  ],
  ...
}

Filtered results (without search_query)

A Youtube search without query is valid with filters (sp). In this example, it is filtered to show only live videos.

Filtered results (without search_query)

JSON Example

{
  ...
  "video_results": [
    {
      "position_on_page": 1,
      "title": "THURSDAY MORNING COFFEE JAZZ - Summer Jazz & Bossa Nova Cafe Music",
      "link": "https://www.youtube.com/watch?v=FaeReGELZbQ",
      "serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=FaeReGELZbQ",
      "watching": 38,
      "live": true,
      "channel": {
        "name": "RelaxingJazz BGM",
        "link": "https://www.youtube.com/channel/UCg7PrNSDUiTxubQqN4U5xrg",
        "thumbnail": "https://yt3.ggpht.com/D53dPBbipcw16XjVg7Tx0Om3BNOCDrFskfKp5j6YZYPsS_K_x0g9e0t_Ap35maa97PuMLBSjRA=s68-c-k-c0x00ffffff-no-rj"
      },
      "description": "THURSDAY MORNING COFFEE JAZZ - Summer Jazz & Bossa Nova Cafe Music Thanks for watching! Don't forget to ...",
      "extensions": [
        "LIVE",
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/FaeReGELZbQ/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDGkijVur4RUOfV8-2ly7AXKXCHDw"
      }
    },
    {
      "position_on_page": 2,
      "title": "WEDNESDAY MORNING JAZZ - Good Mood Jazz Coffee Shop Music - Happy Jazz Bossa Nova for Work, Study",
      "link": "https://www.youtube.com/watch?v=Fr678ezHung",
      "serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=Fr678ezHung",
      "watching": 25,
      "live": true,
      "channel": {
        "name": "RelaxingJazz BGM",
        "link": "https://www.youtube.com/channel/UCg7PrNSDUiTxubQqN4U5xrg",
        "thumbnail": "https://yt3.ggpht.com/D53dPBbipcw16XjVg7Tx0Om3BNOCDrFskfKp5j6YZYPsS_K_x0g9e0t_Ap35maa97PuMLBSjRA=s68-c-k-c0x00ffffff-no-rj"
      },
      "description": "JazzMusic #CoffeeJazz #MorningJazz Thanks for watching! Don't forget to SUBSCRIBE, Like and Share my video if you enjoy it.",
      "extensions": [
        "LIVE",
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/Fr678ezHung/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDVJDgZNsJ7dX6d-TRV2OoTh-smDA"
      }
    },
    {
      "position_on_page": 3,
      "title": "Thursday Morning Jazz - Happy Jazz Coffee and Bossa Nova Music",
      "link": "https://www.youtube.com/watch?v=nVe6PUwO1s8",
      "serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=nVe6PUwO1s8",
      "watching": 2649,
      "live": true,
      "channel": {
        "name": "Relax Cafe Music",
        "link": "https://www.youtube.com/channel/UCaCE5pzy49M8nQ59plgmFOA",
        "verified": true,
        "thumbnail": "https://yt3.ggpht.com/ytc/AMLnZu-qYrNRn5rwt2yF8wRMcgtB7ZpxmZ_tIJnF1Tg2Rg=s88-c-k-c0x00ffffff-no-rj"
      },
      "description": "Happy morning jazz and bossa nova music by Richard Freeman © All music and videos are produced by us and are copyrighted.",
      "extensions": [
        "LIVE",
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/nVe6PUwO1s8/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDysLHwi_Jw5lXnoO3kBZEoJZ94qQ"
      }
    },
    {
      "position_on_page": 4,
      "title": "coffee shop radio // 24/7 lofi hip-hop beats",
      "link": "https://www.youtube.com/watch?v=-5KAN9_CzSA",
      "serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=-5KAN9_CzSA",
      "watching": 1236,
      "live": true,
      "channel": {
        "name": "STEEZYASFUCK",
        "link": "https://www.youtube.com/c/steezyasfvck",
        "verified": true,
        "thumbnail": "https://yt3.ggpht.com/ytc/AMLnZu-2IFWBZJXef1PkcEFggD2fi5lsmTpUptll77F7dQ=s68-c-k-c0x00ffffff-no-rj"
      },
      "description": "Coffee Shop Vibes on Spotify: https://fanlink.to/CSVibes This stream's playlist is curated with an emphasis on meditation and ...",
      "extensions": [
        "LIVE"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/-5KAN9_CzSA/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAPFDzM2KsVstWBeVQhAcm3MeP2mg"
      }
    }
  ],
  ...
}