YouTube Trending Shorts API Documentation
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
USdefines the country whose trending shorts are returned. Check the full list of supported YouTubeglcountries.
-
- Name
-
hl - Required
- Optional
- Description
-
The default parameter
endefines the language of the feed. YouTube picks shorts in that language, so set the country's language to get what local viewers see (for examplehl=jawithgl=JP). Check the full list of supported YouTubehllanguages.
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 sameglandhlto 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_keyauthenticates 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
trueto 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
Set gl to get the shorts trending in another country. likes is left out when YouTube doesn't return a like count.
https://www.searchapi.io/api/v1/search?engine=youtube_trending_shorts
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "youtube_trending_shorts"
}
response = requests.get(url, params=params)
print(response.text)
{
"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
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.
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
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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..."
}
}