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.

Example of the artist top result

JSON Example

{
  ...
  "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.

Example of the song top result

JSON Example

{
  ...
  "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.

Example of the video top result

JSON Example

{
  ...
  "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

Example of the album top result

JSON Example

{
  ...
  "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

Example of the playlist top result

JSON Example

{
  ...
  "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.

Example of the radio top result

JSON Example

{
  ...
  "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.

Example of the episode top result

JSON Example

{
  ...
  "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
      },
      ...
    ],
    ...
  },
  ...
}