YouTube Music Top Result API
When a YouTube Music search contains the top result, it is parsed and exists within the top_result object in the JSON output. The top result is not available with the filter.
The top result has the same fields as the Organic Results of its type. Fields that the top result card doesn't show are missing, e.g. the song top result has no plays.
The API endpoint is https://serpapi.com/search?engine=youtube_music
Head to the playground for a live and interactive demo.
API examples
Example of the artist top result
The artist top result may include the artist songs and albums in items.
{
...
"top_result": {
"type": "artist",
"title": "Drake",
"link": "https://music.youtube.com/channel/UCU6cE7pdJPc6DU2jSrKEsdQ",
"channel": {
"name": "Drake",
"channel_id": "UCU6cE7pdJPc6DU2jSrKEsdQ",
"link": "https://music.youtube.com/channel/UCU6cE7pdJPc6DU2jSrKEsdQ",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCU6cE7pdJPc6DU2jSrKEsdQ&engine=youtube_channel",
"audience": "130M monthly audience",
"extracted_audience": 130000000
},
"thumbnail": "https://yt3.googleusercontent.com/MxNjcRJ-uK4Xvx7u90IhEFLQM8x9LIGTA9VCKHq5U4Wn2jOgiWaMtg-qz329SIzqnCyhdCCB3MpdAGs=w120-h120-p-l90-rj",
"items": [
{
"type": "song",
"title": "Shot For Me",
"link": "https://music.youtube.com/watch?v=wc7JPaRV5uU",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=wc7JPaRV5uU",
"video_id": "wc7JPaRV5uU",
"album": {
"album_id": "MPREb_7BhsOFvMuO4",
"link": "https://music.youtube.com/browse/MPREb_7BhsOFvMuO4"
},
"length": "3:45",
"plays": "179M plays",
"extracted_plays": 179000000,
"explicit": true,
"thumbnail": "https://yt3.googleusercontent.com/18E7TwAgz27m5j9IbDra9jxalSFXQazLXcrEF0VnqjgYAHP32tgbghTb-H_-nHbiDLC_8MvXThkbIBvP=w120-h120-l90-rj"
},
{
"type": "song",
"title": "Dust",
"link": "https://music.youtube.com/watch?v=cdpofb3Pzx8",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=cdpofb3Pzx8",
"video_id": "cdpofb3Pzx8",
"album": {
"album_id": "MPREb_JwjteKgsOTq",
"link": "https://music.youtube.com/browse/MPREb_JwjteKgsOTq"
},
"length": "3:10",
"plays": "25M plays",
"extracted_plays": 25000000,
"thumbnail": "https://yt3.googleusercontent.com/2pVVmtceImeD3b3U1wctFP1Z_FoSZG54tqwQCgbMw-ODxk4f8xZ1gAcMAVfhNW18VHv4wWeBePMIrwk=w120-h120-l90-rj"
},
{
"type": "album",
"title": "HABIBTI (FOMO)",
"link": "https://music.youtube.com/browse/MPREb_L2anhKI1Knd",
"album_id": "MPREb_L2anhKI1Knd",
"playlist_id": "OLAK5uy_k54YC3sRbj37EW5ZLKyYUXyP2WDdoLl_8",
"album_type": "Album",
"year": 2026,
"explicit": true,
"extensions": [
"NEW"
],
"thumbnail": "https://yt3.googleusercontent.com/3FPUVAjcpcScmksLnEZYdP9k1UB0PhwEJpGx-8CDeWhW6cR3Ib9lt5m25PAVpGrjdEK3Yjh_IYvOsTAN=w544-h544-l90-rj"
}
]
},
...
}
Example of the song top result
The song top result may include related videos in items.
{
...
"top_result": {
"type": "song",
"title": "Hotel California",
"link": "https://music.youtube.com/watch?v=BciS5krYL80",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=BciS5krYL80",
"video_id": "BciS5krYL80",
"channels": [
{
"name": "Eagles",
"channel_id": "UC49r4GNHHpc-eQ9hmD2Rg6A",
"link": "https://music.youtube.com/channel/UC49r4GNHHpc-eQ9hmD2Rg6A",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UC49r4GNHHpc-eQ9hmD2Rg6A&engine=youtube_channel"
}
],
"album": {
"album_id": "MPREb_E2rekB6aBjC",
"link": "https://music.youtube.com/browse/MPREb_E2rekB6aBjC"
},
"length": "6:32",
"thumbnail": "https://yt3.googleusercontent.com/s8QFRo91FYOkY2M1967AtulxiQpHXC7pEjWtsGzCQ4ZN25wnvhasHO0S4e_MWm04-HVfmBRvy8jmbq2-ZA=w120-h120-l90-rj",
"items": [
{
"type": "video",
"title": "Hotel California (Live)",
"link": "https://music.youtube.com/watch?v=09839DpTctU",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=09839DpTctU",
"video_id": "09839DpTctU",
"channels": [
{
"name": "Eagles",
"channel_id": "UC49r4GNHHpc-eQ9hmD2Rg6A",
"link": "https://music.youtube.com/channel/UC49r4GNHHpc-eQ9hmD2Rg6A",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UC49r4GNHHpc-eQ9hmD2Rg6A&engine=youtube_channel"
}
],
"views": "945M views",
"extracted_views": 945000000,
"length": "6:45",
"thumbnail": "https://i.ytimg.com/vi/09839DpTctU/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3muQv6Pyu3j6AY_xdlGiw1z58SGMw"
},
{
"type": "video",
"title": "Eagles - Hotel California | Afro House Remix |",
"link": "https://music.youtube.com/watch?v=Sqvn-Zbmejo",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=Sqvn-Zbmejo",
"video_id": "Sqvn-Zbmejo",
"channels": [
{
"name": "Golden Safari",
"channel_id": "UCisnutulj7J2pAHma0oBK-w",
"link": "https://music.youtube.com/channel/UCisnutulj7J2pAHma0oBK-w",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCisnutulj7J2pAHma0oBK-w&engine=youtube_channel"
}
],
"views": "176K views",
"extracted_views": 176000,
"length": "12:52",
"thumbnail": "https://i.ytimg.com/vi/Sqvn-Zbmejo/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3mfD2dcRyrAl1_nEc8MXjfJMTYZXg"
},
{
"type": "video",
"title": "Eagles Farewell I Tour live From Melbourne 2004 ... Hotel California",
"link": "https://music.youtube.com/watch?v=1D7SuszmPYE",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=1D7SuszmPYE",
"video_id": "1D7SuszmPYE",
"channels": [
{
"name": "먼 기억 잊혀진 노래",
"channel_id": "UCebktr532Zw__FtObfK2Q9g",
"link": "https://music.youtube.com/channel/UCebktr532Zw__FtObfK2Q9g",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCebktr532Zw__FtObfK2Q9g&engine=youtube_channel"
}
],
"views": "447K views",
"extracted_views": 447000,
"length": "8:23",
"thumbnail": "https://i.ytimg.com/vi/1D7SuszmPYE/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3lP4LIBNkL-sYPRh_eQEyg63PS5dA"
}
]
},
...
}
Example of the video top result
The video top result may include related videos and episodes in items.
{
...
"top_result": {
"type": "video",
"title": "bad guy",
"link": "https://music.youtube.com/watch?v=DyDfgMOUjCI",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=DyDfgMOUjCI",
"video_id": "DyDfgMOUjCI",
"channels": [
{
"name": "Billie Eilish",
"channel_id": "UCERrDZ8oN0U_n9MphMKERcg",
"link": "https://music.youtube.com/channel/UCERrDZ8oN0U_n9MphMKERcg",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCERrDZ8oN0U_n9MphMKERcg&engine=youtube_channel"
}
],
"views": "1.3B views",
"extracted_views": 1300000000,
"length": "3:26",
"thumbnail": "https://i.ytimg.com/vi/DyDfgMOUjCI/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3mlVlPx7TqTvv47GP5kUbPjUYV2DA",
"items": [
{
"type": "video",
"title": "2Pac - Bad Guy (HD)",
"link": "https://music.youtube.com/watch?v=KdhStVBpyPw",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=KdhStVBpyPw",
"video_id": "KdhStVBpyPw",
"channels": [
{
"name": "Dj Mimo",
"channel_id": "UCeGWsxYy452YSccGWvk9HdA",
"link": "https://music.youtube.com/channel/UCeGWsxYy452YSccGWvk9HdA",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCeGWsxYy452YSccGWvk9HdA&engine=youtube_channel"
}
],
"views": "112M views",
"extracted_views": 112000000,
"length": "3:48",
"thumbnail": "https://i.ytimg.com/vi/KdhStVBpyPw/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3ksFDv4vaf--ZaCv8RCKJZoNGN7xg"
},
{
"type": "episode",
"title": "【纯享版】黄霄雲周震南颠覆性改编《bad guy》 天花板级高音碰撞酷飒说唱 暗黑气场火力全开 直接炸翻舞台!#天赐的声音7 EP11 20260823",
"link": "https://music.youtube.com/podcast/3UuWQVQpo1Y",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=3UuWQVQpo1Y",
"video_id": "3UuWQVQpo1Y",
"published_date": "Aug 22",
"channel": {
"name": "ZJSTV Music Channel-Welcome to subscribe-",
"channel_id": "UCp8cPvx_Od76EL66vvCnhRA",
"link": "https://music.youtube.com/channel/UCp8cPvx_Od76EL66vvCnhRA",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCp8cPvx_Od76EL66vvCnhRA&engine=youtube_channel"
},
"thumbnail": "https://i.ytimg.com/vi/3UuWQVQpo1Y/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3nz53IWmo7JGPHT-6tX3u06kSYu1Q"
},
{
"type": "video",
"title": "DEMETER - BAD GUY [Extended Mix]",
"link": "https://music.youtube.com/watch?v=G17d8EEgK9o",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=G17d8EEgK9o",
"video_id": "G17d8EEgK9o",
"channels": [
{
"name": "Demeter",
"channel_id": "UCzxW0mIbv6-ZUl94nsz_J2w",
"link": "https://music.youtube.com/channel/UCzxW0mIbv6-ZUl94nsz_J2w",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCzxW0mIbv6-ZUl94nsz_J2w&engine=youtube_channel"
}
],
"views": "1.1M views",
"extracted_views": 1100000,
"length": "5:36",
"thumbnail": "https://i.ytimg.com/vi/G17d8EEgK9o/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3mxH6xGdcUCNfB4FxMEW1ZiFYVCPg"
}
]
},
...
}
Example of the album top result
{
...
"top_result": {
"type": "album",
"title": "Abbey Road (Super Deluxe Edition)",
"link": "https://music.youtube.com/browse/MPREb_tQfaWH32ovE",
"album_id": "MPREb_tQfaWH32ovE",
"playlist_id": "OLAK5uy_lqcFZTOPHGwcnP0nYMzNuY0IES0fl7Fe4",
"album_type": "Album",
"channels": [
{
"name": "The Beatles",
"channel_id": "UC2XdaAVUannpujzv32jcouQ",
"link": "https://music.youtube.com/channel/UC2XdaAVUannpujzv32jcouQ",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UC2XdaAVUannpujzv32jcouQ&engine=youtube_channel"
}
],
"year": 1969,
"thumbnail": "https://yt3.googleusercontent.com/g8bzAg2zxvdnm7ismLMYLA9-9azb4y6VP2uOF56A2G2rpsqLHT6mrJWXRKq_VttXQZ-o-jmVgTFIVgdj=w544-h544-l90-rj"
},
...
}
Example of the playlist top result
{
...
"top_result": {
"type": "playlist",
"title": "Pop Certified",
"link": "https://music.youtube.com/playlist?list=RDCLAK5uy_lBNUteBRencHzKelu5iDHwLF6mYqjL-JU",
"playlist_id": "RDCLAK5uy_lBNUteBRencHzKelu5iDHwLF6mYqjL-JU",
"channel": {
"name": "YouTube Music"
},
"thumbnail": "https://yt3.googleusercontent.com/BchO1e_VlImwqaOcFKhjEmQj9x_gfumqInfztMvIlbSoxfpFeyu3uJoMkIDtx22Hng_PCtg2XmWm_g=w544-h544-l90-rj"
},
...
}
Example of the radio top result
The radio top result is a playlist with the description of its featured artists, and it may include videos and songs in items.
{
...
"top_result": {
"type": "playlist",
"title": "Radio • Lofi hip hop",
"link": "https://music.youtube.com/playlist?list=RDATfmbG9maSBoaXAgaG9w",
"playlist_id": "RDATfmbG9maSBoaXAgaG9w",
"description": "Sleepy Fish, Saib, Toonorth, and more",
"thumbnail": "https://music.youtube.com/image/radioart?r=CjwKDS9nLzExZ3JieXgyejAKDS9nLzExYnYwZ2NsNXkKDS9nLzExZjdieXI5MHEKDS9nLzExczJ5MTFrNTEQ6AcY6AdiCAoGCgQKAmVu",
"items": [
{
"type": "video",
"title": "Lofi Girl - Snowman (Music Video)",
"link": "https://music.youtube.com/watch?v=1P5BSm_oFJg",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=1P5BSm_oFJg",
"video_id": "1P5BSm_oFJg",
"channels": [
{
"name": "Lofi Girl",
"channel_id": "UCi5YpRRZmwegT235crEZ2YQ",
"link": "https://music.youtube.com/channel/UCi5YpRRZmwegT235crEZ2YQ",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCi5YpRRZmwegT235crEZ2YQ&engine=youtube_channel"
}
],
"views": "5M views",
"extracted_views": 5000000,
"length": "3:16",
"thumbnail": "https://i.ytimg.com/vi/1P5BSm_oFJg/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3nMtL6p5ggoBvfk4EOFQt9NJGRwNw"
},
{
"type": "song",
"title": "i'm closing my eyes",
"link": "https://music.youtube.com/watch?v=xSB8trUFX1A",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=xSB8trUFX1A",
"video_id": "xSB8trUFX1A",
"channels": [
{
"name": "potsu",
"channel_id": "UCxBu7h_ACXyfvnpG_rQKI9w",
"link": "https://music.youtube.com/channel/UCxBu7h_ACXyfvnpG_rQKI9w",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UCxBu7h_ACXyfvnpG_rQKI9w&engine=youtube_channel"
}
],
"album": {
"album_id": "MPREb_JDuUooRZ16a",
"link": "https://music.youtube.com/browse/MPREb_JDuUooRZ16a"
},
"length": "1:59",
"plays": "47M plays",
"extracted_plays": 47000000,
"thumbnail": "https://yt3.googleusercontent.com/9RdlXUjbO7v_yj6flRr3z3vFqE3QQaABDPh5Urm0WaEBDzMT0AT1ZT4qYW2_EcZuGzAKoqkfqN0mMaE=w120-h120-l90-rj"
},
{
"type": "song",
"title": "affection",
"link": "https://music.youtube.com/watch?v=NAkZ8gUXcIE",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=NAkZ8gUXcIE",
"video_id": "NAkZ8gUXcIE",
"channels": [
{
"name": "Jinsang",
"channel_id": "UClpcunja__49WB1aKj-18Eg",
"link": "https://music.youtube.com/channel/UClpcunja__49WB1aKj-18Eg",
"serpapi_youtube_channel_link": "https://serpapi.com/search.json?channel_id=UClpcunja__49WB1aKj-18Eg&engine=youtube_channel"
}
],
"album": {
"album_id": "MPREb_nUbG87iR0dn",
"link": "https://music.youtube.com/browse/MPREb_nUbG87iR0dn"
},
"length": "1:58",
"plays": "2.8M plays",
"extracted_plays": 2800000,
"thumbnail": "https://yt3.googleusercontent.com/bccEOm3VednkUnNDN6hhHyF_9C6v0XF0LZrNuiY_sGYthYm91rLfY0TfIdL2BzCX28gloOgL9Lkk5Ak=w120-h120-l90-rj"
}
]
},
...
}
Example of the episode top result
The episode top result includes its podcast.
{
...
"top_result": {
"type": "episode",
"title": "Elon Musk: War, AI, Aliens, Politics, Physics, Video Games, and Humanity | Lex Fridman Podcast #400",
"link": "https://music.youtube.com/podcast/JN3KPFbWCy8",
"serpapi_youtube_video_link": "https://serpapi.com/search.json?engine=youtube_video&v=JN3KPFbWCy8",
"video_id": "JN3KPFbWCy8",
"published_date": "Nov 9, 2023",
"podcast": {
"title": "Lex Fridman Podcast",
"playlist_id": "PLrAXtmErZgOdP_8GztsuKi9nrraNbKKp4",
"link": "https://music.youtube.com/playlist?list=PLrAXtmErZgOdP_8GztsuKi9nrraNbKKp4"
},
"thumbnail": "https://i.ytimg.com/vi/JN3KPFbWCy8/hqdefault.jpg?sqp=-oaymwEWCJADEOEBIAQqCggAEOADGC0guwJIWg&rs=AMzJL3m5IPX7RLbR-VHJ-wnc_eDM1Gxf0Q"
},
...
}
JSON structure overview
{
...
"top_result": {
"type": "String - Type of the top result",
// Supported values:
// - `artist`
// - `song`
// - `video`
// - `album`
// - `audiobook`
// - `track`
// - `playlist`
// - `podcast`
// - `episode`
// - `profile`
// please refer to Organic Results page for the rest of the fields of each type
"description": "String - Description of the playlist (e.g. featured artists of the radio)",
"items": [
{
"type": "String - Type of the item, e.g. `song`, `video`, `album` or `episode`",
// please refer to Organic Results page for the rest of the fields
},
...
],
...
},
...
}