YouTube Category Results API

/ Home / YouTube Search API / Category Results

This kind of results are similar to the main YouTube Video Results, except that they are categorized and put under different "categories" (e.g. Top news, Latest from..., etc). When SerpApi encounters this type of results, we add them to our JSON output. For each category result, we are able to extract its position_on_page, title, link, channel, published_date, views, length, thumbnail and more.

YouTube category results examples

Top news category results

Top news category results

JSON Example

{
  ...
  "top_news": [
    {
      "position_on_page": 2,
      "title": "Star Wars: The Clone Wars - Official Ahsoka Teaser Trailer",
      "link": "https://www.youtube.com/watch?v=MmPsxuSsLzo",
      "channel": {
        "name": "IGN",
        "link": "https://www.youtube.com/user/IGNentertainment",
        "verified": true
      },
      "published_date": "18 hours ago",
      "views": 62630,
      "length": "1:01",
      "description": "After leaving the Jedi Order, Ahsoka Tano finds herself in the underworld of Coruscant where she befriends aspiring pilot Trace ...",
      "extensions": [
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/MmPsxuSsLzo/hqdefault.jpg?sqp=-oaymwEZCNACELwBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLAoTiu9H4lGyAaeYJyJLiZX_zib2A",
        "rich": "https://i.ytimg.com/an_webp/MmPsxuSsLzo/mqdefault_6s.webp?du=3000&sqp=CJL4zfMF&rs=AOn4CLDQq2qTaZSa65GpZFBnf-3vgX3o-g"
      }
    },
    {
      "position_on_page": 3,
      "title": "Richard E. Grant Breaks Down His Career, from 'Downton Abbey' to 'Star Wars' | Vanity Fair",
      "link": "https://www.youtube.com/watch?v=J1VBVaeeG6k",
      "channel": {
        "name": "Vanity Fair",
        "link": "https://www.youtube.com/user/VanityFairMagazine",
        "verified": true
      },
      "published_date": "1 day ago",
      "views": 24750,
      "length": "25:30",
      "description": "Richard E. Grants takes us through his illustrious career, including his roles in 'Withnail & I,' 'Warlock,' 'L.A. Story,' 'The Player,' ...",
      "extensions": [
        "New",
        "CC"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/J1VBVaeeG6k/hqdefault.jpg?sqp=-oaymwEZCNACELwBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLD1MthSQyoKOrwjMOg002Yz6xWGfg",
        "rich": "https://i.ytimg.com/an_webp/J1VBVaeeG6k/mqdefault_6s.webp?du=3000&sqp=CLXxzfMF&rs=AOn4CLCnVZrG4oadKIMzwlADnCXlPH0DnQ"
      }
    },
    {
      "position_on_page": "hidden",
      "title": "Star Wars: The Rise of Skywalker - Official "Every Ship" Behind The Scenes",
      "link": "https://www.youtube.com/watch?v=Hgkt9jTx-bM",
      "channel": {
        "name": "IGN",
        "link": "https://www.youtube.com/user/IGNentertainment",
        "verified": true
      },
      "published_date": "15 hours ago",
      "views": 26943,
      "length": "1:38",
      "description": "The visual effects artists behind Episode IX break down all the ships from the franchise's history that appeared in the climactic ...",
      "extensions": [
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/Hgkt9jTx-bM/hqdefault.jpg?sqp=-oaymwEZCNACELwBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLAam_C2C0H2VRQwrL4a0cjIhTUEYw",
        "rich": "https://i.ytimg.com/an_webp/Hgkt9jTx-bM/mqdefault_6s.webp?du=3000&sqp=CKCAzvMF&rs=AOn4CLAwuqkdnikVDEPj4x_QZh3pibZTqg"
      }
    },
    ...
  ],
  ...
}

Latest from Star Wars category results

Latest from Star Wars category results

JSON Example

{
  ...
  "latest_from_star_wars": [
    {
      "position_on_page": 12,
      "title": "Dale Hopkins and Finding Strength in Star Wars | Our Star Wars Stories",
      "link": "https://www.youtube.com/watch?v=NnLStx_rF7g",
      "channel": {
        "name": "Star Wars",
        "link": "https://www.youtube.com/user/starwars",
        "verified": true
      },
      "published_date": "19 hours ago",
      "views": 11849,
      "length": "8:45",
      "description": "Jordan Hembrough goes to Cleveland, Ohio, to meet Dale Hopkins, a cancer survivor who found strength in Star Wars -- along ...",
      "extensions": [
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/NnLStx_rF7g/hqdefault.jpg?sqp=-oaymwEZCNACELwBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLDMhbYX9TSHgDX8P59-vZwwEbu1GA",
        "rich": "https://i.ytimg.com/an_webp/NnLStx_rF7g/mqdefault_6s.webp?du=3000&sqp=CNjpzfMF&rs=AOn4CLByjj3g0pXR0f5K1mCiyb8uwbhmaw"
      }
    },
    {
      "position_on_page": 13,
      "title": "Inside the Pasaana Chase | Star Wars: The Rise of Skywalker",
      "link": "https://www.youtube.com/watch?v=yYmJxBGfgXM",
      "channel": {
        "name": "Star Wars",
        "link": "https://www.youtube.com/user/starwars",
        "verified": true
      },
      "published_date": "2 days ago",
      "views": 37321,
      "length": "1:16",
      "description": "In this exclusive clip from The Skywalker Legacy, an in-depth documentary on the making of Star Wars: The Rise of Skywalker, ...",
      "extensions": [
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/yYmJxBGfgXM/hqdefault.jpg?sqp=-oaymwEZCNACELwBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLCAU08OWdnBlWlWCmaq1gcBLLghyg",
        "rich": "https://i.ytimg.com/an_webp/yYmJxBGfgXM/mqdefault_6s.webp?du=3000&sqp=CNqBzvMF&rs=AOn4CLD7FfQc2i_8WmzOU78x6GBnffVrgA"
      }
    },
    {
      "position_on_page": "hidden",
      "title": "Clone Wars Download: "Unfinished Business"",
      "link": "https://www.youtube.com/watch?v=AIfva5TkPfM",
      "channel": {
        "name": "Star Wars",
        "link": "https://www.youtube.com/user/starwars",
        "verified": true
      },
      "published_date": "3 days ago",
      "views": 84935,
      "length": "4:24",
      "description": "Go behind the scenes of "Unfinished Business" from the final season of Star Wars: The Clone Wars with executive producer Dave ...",
      "extensions": [
        "New"
      ],
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/AIfva5TkPfM/hqdefault.jpg?sqp=-oaymwEZCNACELwBSFXyq4qpAwsIARUAAIhCGAFwAQ==&rs=AOn4CLBhBwtDeSy5a8BjPe7ImoCkz9QTkA",
        "rich": "https://i.ytimg.com/an_webp/AIfva5TkPfM/mqdefault_6s.webp?du=3000&sqp=CK_pzfMF&rs=AOn4CLAeaI3xkPvun8JTjmMhYS5aBY1Wog"
      }
    },
    ...
  ],
  ...
}