YouTube Trending Shorts API Documentation

GET   /api/v1/search?engine=youtube_trending_shorts

The YouTube Trending Shorts API returns the shorts YouTube's Shorts feed is showing in a country. Each short comes with its title and channel, plus views, likes, comments, publish date, duration, music and keywords when YouTube returns them.

API Parameters

Localization

  • Name
    gl
    Required
    Optional
    Description

    The default parameter US defines the country whose trending shorts are returned. Check the full list of supported YouTube gl countries.

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the language of the feed. YouTube picks shorts in that language, so set the country's language to get what local viewers see (for example hl=ja with gl=JP). Check the full list of supported YouTube hl languages.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    A token used to retrieve the next batch of trending shorts. Each response returns pagination.next_page_token. Pass it back with the same gl and hl to keep scrolling the feed.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines the engine that will be used to retrieve real-time data. To retrieve trending YouTube shorts, it must be set to youtube_trending_shorts.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response

Set gl to get the shorts trending in another country. likes is left out when YouTube doesn't return a like count.

GET
https://www.searchapi.io/api/v1/search?engine=youtube_trending_shorts
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "youtube_trending_shorts"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_RqXLK4ZloPW8iRQgxM8z2jE9",
    "status": "Success",
    "created_at": "2026-11-03T12:39:27Z",
    "request_time_taken": 8.12,
    "parsing_time_taken": 0.0,
    "total_time_taken": 8.12,
    "request_url": "https://www.youtube.com/shorts",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_RqXLK4ZloPW8iRQgxM8z2jE9.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_RqXLK4ZloPW8iRQgxM8z2jE9"
  },
  "search_parameters": {
    "engine": "youtube_trending_shorts",
    "gl": "US",
    "hl": "en"
  },
  "shorts": [
    {
      "position": 1,
      "id": "7J2V-np5Bks",
      "title": "How a Jungle Hole Becomes the Cu Chi Tunnels",
      "link": "https://www.youtube.com/shorts/7J2V-np5Bks",
      "description": "You dig a hole in the jungle to hide from the bombs... and end up building a whole city underground.\nTrapdoors hidden under leaves, air vents inside termite mounds, a smoke tunnel that turns cooking smoke into morning mist, and a water trap that stops the smoke the soldiers pump in.\nThe real Cu Chi tunnels in Vietnam ran for well over a hundred kilometres, with kitchens, bedrooms and even hospitals deep under the jungle.\n\n#cuchitunnels #vietnamwar #history #engineering #howitworks #shorts",
      "views": 29002125,
      "likes": 783187,
      "comments": 3976,
      "publish_date": "2026-10-24T10:20:56-07:00",
      "length": "1:10",
      "length_seconds": 70,
      "category": "People & Blogs",
      "keywords": [
        "cu chi tunnels",
        "..."
      ],
      "is_family_safe": true,
      "channel": {
        "id": "UCo4tJKEcLh_Erm48ZRug-9w",
        "title": "You Made It",
        "handle": "@youmadeit3d",
        "link": "https://www.youtube.com/channel/UCo4tJKEcLh_Erm48ZRug-9w"
      },
      "music": {
        "title": "Original Sound",
        "thumbnail": "https://yt3.ggpht.com/KdoJyMtshpvbeD8Zbh00l8oAQ0XYHe8xa9lZClt5jIzv1y7L2dIFok2vaX5R_7iLdo-l6KDF=s176-c-k-c0x00ffffff-no-rj"
      },
      "thumbnail": "https://i.ytimg.com/vi/7J2V-np5Bks/hq720.jpg?sqp=-oaymwEoCJUDENAFSFryq4qpAxoIARUAAIhC0AEB2AEB4gEKCBgQAhgGOAFAAQ==&rs=AOn4CLAeI0Lpt9BwgZhSDKj4gYuMhieFLg"
    },
    "..."
  ],
  "pagination": {
    "next_page_token": "GnAKC09kZENTdHg2Y2dVGAcgAjCD07GwjOGq2jZCUwgIECAaNfIGMgowCgWaAQIQARgBIgIgAerE77wLFRITCNWpye7o65cDFTAKiAkdsWgWpeq6yvMNAggMIgcKBTMyOlNIKg0KC09kZENTdHg2Y2dVKgIYDEIAYgRSRFNIetkFCAkYCDLZAQoLT2RkQ1N0eDZjZ1USATAaCwilxI3XBhDIpIpzIgYIlKeU1wYqBAgNEAEyJBIHCOYBEAEYARIHCJADEAcYARIHCJEDEAEYARIHCI8HEAEYATozCgMI9AIKAwjXARICCAMSAggjEgIIShIDCNcBEgMI9AISAwi-BxoDCL4HGgIIShoDCPQCQgcKAwjMARABSgcKAwjNARABUgcKAwjMARABWgwSCggBEAEqBAgBEAF6KAoICPxPFV66yT4KCAj6ThX0_ZQ-CggIgE8VnMQgPgoICPNSFXNoET5CC09kZENTdHg2Y2dVShhVQ1NEUnNERzRDeDIyYkNMcVlFZ05TY0FY95Cwi5o0ajcKC1dNQ0huemVSU25NEhhVQ01sclFXVEdLZW9JYTZMdVR5bnZpeFEdEmntQSD4__________8BajcKC1JuU1lrdTcyaEVJEhhVQ25tR0lrdy1LZEkwVzVzaWFrS1BLb2cdgAz1QSD5__________8BajcKC3RfdHZYYUh6Sms0EhhVQzNCeFdtOTJsanl1NmEteUJSWVFVRmcdBXXUQSD6__________8BajcKCzd4Uzg3aUFjdGtVEhhVQ19WZUZXbE5uUkln..."
  }
}

Next Page

Next Page

The feed changes on every request, so each call returns a new set of shorts, usually around 10. Pass pagination.next_page_token back as next_page_token, with the same gl and hl, to get the next batch. A later batch can repeat a short from an earlier one, so dedupe by id. Ads in the feed are left out.

GET
https://www.searchapi.io/api/v1/search?engine=youtube_trending_shorts&next_page_token=GnAKC09kZENTdHg2Y2dVGAcgAjCD07GwjOGq2jZCUwgIECAaNfIGMgowCgWaAQIQARgBIgIgAerE77wLFRITCNWpye7o65cDFTAKiAkdsWgWpeq6yvMNAggMIgcKBTMyOlNIKg0KC09kZENTdHg2Y2dVKgIYDEIAYgRSRFNIetkFCAkYCDLZAQoLT2RkQ1N0eDZjZ1USATAaCwilxI3XBhDIpIpzIgYIlKeU1wYqBAgNEAEyJBIHCOYBEAEYARIHCJADEAcYARIHCJEDEAEYARIHCI8HEAEYATozCgMI9AIKAwjXARICCAMSAggjEgIIShIDCNcBEgMI9AISAwi-BxoDCL4HGgIIShoDCPQCQgcKAwjMARABSgcKAwjNARABUgcKAwjMARABWgwSCggBEAEqBAgBEAF6KAoICPxPFV66yT4KCAj6ThX0_ZQ-CggIgE8VnMQgPgoICPNSFXNoET5CC09kZENTdHg2Y2dVShhVQ1NEUnNERzRDeDIyYkNMcVlFZ05TY0FY95Cwi5o0ajcKC1dNQ0huemVSU25NEhhVQ01sclFXVEdLZW9JYTZMdVR5bnZpeFEdEmntQSD4__________8BajcKC1JuU1lrdTcyaEVJEhhVQ25tR0lrdy1LZEkwVzVzaWFrS1BLb2cdgAz1QSD5__________8BajcKC3RfdHZYYUh6Sms0EhhVQzNCeFdtOTJsanl1NmEteUJSWVFVRmcdBXXUQSD6__________8BajcKCzd4Uzg3aUFjdGtVEhhVQ19WZUZXbE5uUklnNTU4aEFlSXBKNHcdWwslQiD7__________8BajcKC3BLQk1sdUNvYzg4EhhVQ3BOVzFhQ2hyeDNCUGZtMTNYcXlfWkEd_ChKQiD8__________8BajcKC2JtSDRqQ05lTjhJEhhVQzk5S1VjblhQdzRlQVJwWlEyN0xaVFEdLEjYQSD9__________8BajcKC0NLTDgzNzJ6TFJrEhhVQ0I1M1hXWE1USTd0Y0RrZTRMdGZ3UEEd_Tu3QSD-__________8BajcKC09kZENTdHg2Y2dVEhhVQ1NEUnNERzRDeDIyYkNMcVlFZ05TY0EdfVdvQiD___________8BoAEB
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "youtube_trending_shorts",
  "next_page_token": "GnAKC09kZENTdHg2Y2dVGAcgAjCD07GwjOGq2jZCUwgIECAaNfIGMgowCgWaAQIQARgBIgIgAerE77wLFRITCNWpye7o65cDFTAKiAkdsWgWpeq6yvMNAggMIgcKBTMyOlNIKg0KC09kZENTdHg2Y2dVKgIYDEIAYgRSRFNIetkFCAkYCDLZAQoLT2RkQ1N0eDZjZ1USATAaCwilxI3XBhDIpIpzIgYIlKeU1wYqBAgNEAEyJBIHCOYBEAEYARIHCJADEAcYARIHCJEDEAEYARIHCI8HEAEYATozCgMI9AIKAwjXARICCAMSAggjEgIIShIDCNcBEgMI9AISAwi-BxoDCL4HGgIIShoDCPQCQgcKAwjMARABSgcKAwjNARABUgcKAwjMARABWgwSCggBEAEqBAgBEAF6KAoICPxPFV66yT4KCAj6ThX0_ZQ-CggIgE8VnMQgPgoICPNSFXNoET5CC09kZENTdHg2Y2dVShhVQ1NEUnNERzRDeDIyYkNMcVlFZ05TY0FY95Cwi5o0ajcKC1dNQ0huemVSU25NEhhVQ01sclFXVEdLZW9JYTZMdVR5bnZpeFEdEmntQSD4__________8BajcKC1JuU1lrdTcyaEVJEhhVQ25tR0lrdy1LZEkwVzVzaWFrS1BLb2cdgAz1QSD5__________8BajcKC3RfdHZYYUh6Sms0EhhVQzNCeFdtOTJsanl1NmEteUJSWVFVRmcdBXXUQSD6__________8BajcKCzd4Uzg3aUFjdGtVEhhVQ19WZUZXbE5uUklnNTU4aEFlSXBKNHcdWwslQiD7__________8BajcKC3BLQk1sdUNvYzg4EhhVQ3BOVzFhQ2hyeDNCUGZtMTNYcXlfWkEd_ChKQiD8__________8BajcKC2JtSDRqQ05lTjhJEhhVQzk5S1VjblhQdzRlQVJwWlEyN0xaVFEdLEjYQSD9__________8BajcKC0NLTDgzNzJ6TFJrEhhVQ0I1M1hXWE1USTd0Y0RrZTRMdGZ3UEEd_Tu3QSD-__________8BajcKC09kZENTdHg2Y2dVEhhVQ1NEUnNERzRDeDIyYkNMcVlFZ05TY0EdfVdvQiD___________8BoAEB"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_LqdKeRrXoaEwur0o0Pl1Ymzw",
    "status": "Success",
    "created_at": "2026-11-03T13:01:57Z",
    "request_time_taken": 7.93,
    "parsing_time_taken": 0.0,
    "total_time_taken": 7.94,
    "request_url": "https://www.youtube.com/shorts",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_LqdKeRrXoaEwur0o0Pl1Ymzw.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_LqdKeRrXoaEwur0o0Pl1Ymzw"
  },
  "search_parameters": {
    "engine": "youtube_trending_shorts",
    "gl": "US",
    "hl": "en",
    "next_page_token": "GnAKC09kZENTdHg2Y2dVGAcgAjCD07GwjOGq2jZCUwgIECAaNfIGMgowCgWaAQIQARgBIgIgAerE77wLFRITCNWpye7o65cDFTAKiAkdsWgWpeq6yvMNAggMIgcKBTMyOlNIKg0KC09kZENTdHg2Y2dVKgIYDEIAYgRSRFNIetkFCAkYCDLZAQoLT2RkQ1N0eDZjZ1USATAaCwilxI3XBhDIpIpzIgYIlKeU1wYqBAgNEAEyJBIHCOYBEAEYARIHCJADEAcYARIHCJEDEAEYARIHCI8HEAEYATozCgMI9AIKAwjXARICCAMSAggjEgIIShIDCNcBEgMI9AISAwi-BxoDCL4HGgIIShoDCPQCQgcKAwjMARABSgcKAwjNARABUgcKAwjMARABWgwSCggBEAEqBAgBEAF6KAoICPxPFV66yT4KCAj6ThX0_ZQ-CggIgE8VnMQgPgoICPNSFXNoET5CC09kZENTdHg2Y2dVShhVQ1NEUnNERzRDeDIyYkNMcVlFZ05TY0FY95Cwi5o0ajcKC1dNQ0huemVSU25NEhhVQ01sclFXVEdLZW9JYTZMdVR5bnZpeFEdEmntQSD4__________8BajcKC1JuU1lrdTcyaEVJEhhVQ25tR0lrdy1LZEkwVzVzaWFrS1BLb2cdgAz1QSD5__________8BajcKC3RfdHZYYUh6Sms0EhhVQzNCeFdtOTJsanl1NmEteUJSWVFVRmcdBXXUQSD6__________8BajcKCzd4Uzg3aUFjdGtVEhhVQ19WZUZXbE5uUkln..."
  },
  "shorts": [
    {
      "position": 1,
      "id": "HXxV5xR0tdY",
      "title": "F1 Drivers Are Not Normal Humans 😨",
      "link": "https://www.youtube.com/shorts/HXxV5xR0tdY",
      "description": "Copyright Disclaimer: - Under section 107 of the copyright Act 1976, allowance is made for FAIR USE for purpose such a as criticism, comment, news reporting, teaching, scholarship and research. Fair use is a use permitted by copyright statues that might otherwise be infringing. Non- Profit, educational or personal use tips the balance in favor of FAIR USE.",
      "views": 27238858,
      "likes": 594799,
      "comments": 598,
      "publish_date": "2026-10-05T03:32:16-07:00",
      "length": "0:54",
      "length_seconds": 54,
      "category": "People & Blogs",
      "is_family_safe": true,
      "channel": {
        "id": "UC6sz2-ogQz1SbKCMRSdodyA",
        "title": "Klimt",
        "handle": "@Klimt-YT",
        "link": "https://www.youtube.com/channel/UC6sz2-ogQz1SbKCMRSdodyA"
      },
      "music": {
        "title": "Original Sound",
        "thumbnail": "https://yt3.ggpht.com/XdJB7PCme7L53GudB5Ahj9PjOXi8x_L1dJIsb-FQlcc0wV0ahB6ssm8MGhEiWS1m3GNBPX5T=s176-c-k-c0x00ffffff-no-rj"
      },
      "thumbnail": "https://i.ytimg.com/vi/HXxV5xR0tdY/oar2.jpg?sqp=-oaymwEsCJwEENAFSFqQAgHyq4qpAxsIARUAAIhC2AEB4gEKCBgQAhgGOAFAAbgC9xg=&rs=AOn4CLARneqQeNMms2EOBEVgHA-axlbwHA"
    },
    "..."
  ],
  "pagination": {
    "next_page_token": "GnAKCzh3ZDNDRlNWRmRvGA4gAjCD07GwjOGq2jZCUwgIECAaNfIGMgowCgWaAQIQARgBIgIgAerE77wLFRITCNWpye7o65cDFTAKiAkdsWgWpeq6yvMNAggMIgcKBTMyOlNIKg0KCzh3ZDNDRlNWRmRvKgIYDEIAYgRSRFNIeqEDCBUYCCASMvMBCgs4d2QzQ0ZTVkZkbxIBMBoMCMrE2NYGEOixtbcCIgYI1p2B1wYqBAgNEAEyGxIHCOYBEAEYARIHCJEDEAEYARIHCI8HEAEYATpLCgMI-wIKAwj2BgoDCJ4GEgIIAhICCEESAghCEgIIUBIDCPsCEgMIswQSAwibBhIDCJ4GEgMI8gYSAwj2BhoCCEIaAwjyBhoDCPsCQgcKAwjLARABSgcKAwjNARABUgcKAwjLARABWgwSCggBEAAqBAgBEAF6MgoICJJPFd9PjT4KCAjxaBUj23k-CggItmwV1XhpPgoICLxSFZzEID4KCAj-aRV3LaE9Qgs4d2QzQ0ZTVkZkb0oYVUMzUzBXOERxLWxkVzVpRldtNV83ZmRBUABYybiCjJo0ajcKC0lldzhlTnlOSU9jEhhVQ09BSnRKTkYzMTVZczBwdWRRTllTQncdo69NQSD-__________8BajcKCzh3ZDNDRlNWRmRvEhhVQzNTMFc4RHEtbGRXNWlGV201XzdmZEEdReUZQiD___________8BoAEB..."
  }
}