YouTube Featured Panel API
For some searches, YouTube shows a panel beside the results about a channel, a topic, an album or a show. SerpApi renders it as the featured_panel object: its type, link, title, subtitle (with a handle when it is a channel's @handle), thumbnail and the videos of the panel.
The API endpoint is https://serpapi.com/search?engine=youtube
Head to the playground for a live and interactive demo.
API examples
Channel
A search that names a channel returns the channel with its latest videos. type is channel, with its channel_id, handle and verified.
{
...
"featured_panel": {
"type": "channel",
"channel_id": "UCBJycsmduvYEL83R_U4JriQ",
"link": "https://www.youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ",
"title": "Marques Brownlee",
"subtitle": "@mkbhd",
"handle": "@mkbhd",
"verified": true,
"thumbnail": "https://yt3.ggpht.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s176-c-k-c0x00ffffff-no-rj",
"videos": [
{
"title": "Macbook PROLED XDR Impressions: They Said They Wouldn't!",
"link": "https://www.youtube.com/watch?v=2reQut8WNGc",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=2reQut8WNGc",
"video_id": "2reQut8WNGc",
"subtitle": "Marques Brownlee • 8.1M • 1d ago",
"views": 8100000,
"published_date": "1d ago",
"length": "10:54",
"thumbnail": "https://i.ytimg.com/vi/2reQut8WNGc/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBaPrT8qkGl9j3fYkW7nB2XWB8jmA"
},
{
"title": "This can SEE Sound!",
"link": "https://www.youtube.com/watch?v=ai1gIWacf0I",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=ai1gIWacf0I",
"video_id": "ai1gIWacf0I",
"subtitle": "2.1M • 2d ago",
"views": 2100000,
"published_date": "2d ago",
"length": "1:31",
"thumbnail": "https://i.ytimg.com/vi/ai1gIWacf0I/hq720.jpg?sqp=-oaymwE2COgCEMoBSFXyq4qpAygIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARg_IFgoZTAP&rs=AOn4CLDximuVF9x1HOVXghJ6cFe51HbnBw"
},
...
]
},
...
}
Topic
A game, a team or a league has a channel generated by YouTube, with no handle: subtitle says what the topic is. videos can come from other channels. An upcoming video, such as a game or a scheduled stream, has upcoming and scheduled_for (Pacific time) instead of views and length.
{
...
"featured_panel": {
"type": "channel",
"channel_id": "UCQvWX73GQygcwXOTSf_VDVg",
"link": "https://www.youtube.com/channel/UCQvWX73GQygcwXOTSf_VDVg",
"title": "Minecraft",
"subtitle": "Video game • Released: 2009",
"videos": [
{
"title": "FINAL FEATURES FROM UPCOMING GAME DROP!",
"link": "https://www.youtube.com/watch?v=XJlkhdX7a0s",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=XJlkhdX7a0s",
"video_id": "XJlkhdX7a0s",
"subtitle": "Minecraft • 1M • 2d ago",
"views": 1000000,
"published_date": "2d ago",
"length": "0:18",
"thumbnail": "https://i.ytimg.com/vi/XJlkhdX7a0s/hq720.jpg?sqp=-oaymwE2COgCEMoBSFXyq4qpAygIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARg1IEkofzAP&rs=AOn4CLDyXnnXCS23PoUcVRWtrzpjlchSeA"
},
{
"title": "WOULD YOU DARE GO INSIDE?",
"link": "https://www.youtube.com/watch?v=KGIGpi07EEM",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=KGIGpi07EEM",
"video_id": "KGIGpi07EEM",
"subtitle": "906K • 5d ago",
"views": 906000,
"published_date": "5d ago",
"length": "0:28",
"thumbnail": "https://i.ytimg.com/vi/KGIGpi07EEM/hq720.jpg?sqp=-oaymwE2COgCEMoBSFXyq4qpAygIARUAAIhCGABwAcABBvABAfgBtgiAAoAPigIMCAAQARh_IDwoFTAP&rs=AOn4CLBkwfQOohinfl-YVynQlAJTZ-RzRA"
},
...
]
},
...
}
Album
type is playlist, with its playlist_id, and videos are the tracks of the album.
{
...
"featured_panel": {
"type": "playlist",
"playlist_id": "OLAK5uy_m2pWyg-txDMGdNNiHtjorZVRbrVg_Ihxo",
"link": "https://www.youtube.com/playlist?list=OLAK5uy_m2pWyg-txDMGdNNiHtjorZVRbrVg_Ihxo",
"title": "Abbey Road",
"subtitle": "Album • The Beatles",
"thumbnail": "https://i9.ytimg.com/s_p/OLAK5uy_m2pWyg-txDMGdNNiHtjorZVRbrVg_Ihxo/sddefault.jpg?sqp=CMj6tdcGir7X7AMICMiU-dUGEAE=&rs=AOn4CLAu5n2mK2BBV7DGeGcS0pv11nqkAg&v=1790855752",
"videos": [
{
"title": "Come Together (2019 Mix)",
"link": "https://www.youtube.com/watch?v=45cYwDMibGo",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=45cYwDMibGo",
"video_id": "45cYwDMibGo",
"subtitle": "The Beatles",
"length": "4:19"
},
{
"title": "Something (Remastered 2009)",
"link": "https://www.youtube.com/watch?v=UelDrZ1aFeY",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=UelDrZ1aFeY",
"video_id": "UelDrZ1aFeY",
"subtitle": "The Beatles",
"length": "3:08"
},
...
]
},
...
}
Show
type is show, with its show_id, and videos are its episodes.
{
...
"featured_panel": {
"type": "show",
"show_id": "SCxoxXLn_0TfdvIVbVWIMdfw",
"link": "https://www.youtube.com/show/SCxoxXLn_0TfdvIVbVWIMdfw?season=1&sbp=CgEx",
"title": "Breaking Bad",
"subtitle": "6 seasons • 81 episodes",
"thumbnail": "https://yt3.googleusercontent.com/brDFnFbkZzRI_AgyPZmhB74KJ2xLleM2a9ncjhiDXhWiOJRc1bwWH_XymKrWHNvzDc8amCby",
"videos": [
{
"title": "Breaking Bad - Pilot",
"link": "https://www.youtube.com/watch?v=PNxGMkcus_g",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=PNxGMkcus_g",
"video_id": "PNxGMkcus_g",
"subtitle": "Episode 1",
"length": "58:02"
},
{
"title": "Breaking Bad - Cat's in the Bag...",
"link": "https://www.youtube.com/watch?v=AnvQ8KUPqec",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=AnvQ8KUPqec",
"video_id": "AnvQ8KUPqec",
"subtitle": "Episode 2",
"length": "48:07"
},
...
]
},
...
}