YouTube Trending Videos
YouTube's trending pages rank the videos drawing the most attention in a category such as news, gaming or sports for each country, showing each video's position, channel, view count, length and how long ago it went up. Following these rankings shows which stories, games and creators are breaking out in a market and how fast a video climbs into the list or falls off it.
YouTube Trending Videos API Features
- Seven category trending pagescategory selects the news, gaming, sports, learning, courses, fashion or shopping trending page, so each task follows the list a viewer of that category sees.
- Any country by its two-letter coderegion takes a code such as US, GB, JP or BR and returns that country's version of the page, which often ranks different videos for the same category.
- Rank kept with every videorank records each video's position from 1 down, alongside category and region, so a row still makes sense after you mix several lists in one table.
- Channel behind each trending videoauthor carries the channel ID, name, @handle, link, avatar and verified badge, which lets you group trending videos by channel without a second lookup.
- Views, length and thumbnailmetrics.views_count, duration_seconds, thumbnail_url and the description snippet in text describe each video as it appears on the trending page.
YouTube Trending Videos API Parameters
| Parameters | Required | Description |
|---|---|---|
category | Required | Trending page to read: news, gaming, sports, learning, courses, fashion or shopping. |
region | Optional | Two-letter country code of the trending page, such as US, GB or JP. Defaults to US. |
results_limit | Optional | How many videos to return from the top of the list, from 1 to 50. Defaults to 50. |
How to Use the YouTube Trending Videos API
Choose a category and a country, send them to the YouTube Trending Videos API and read the ranked list from the finished task.
- POST {"category": "news", "region": "US", "results_limit": 50} to /v1/youtube/trending-videos and keep the task_id.
- Call GET /v1/tasks/{task_id} every few seconds until status is succeeded.
- Read the videos in results.items, ordered by rank; when results.has_more is true, pass results.next_cursor to load the next page.
curl -X POST "https://api.socq.ai/v1/youtube/trending-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category":"gaming","region":"GB","results_limit":10}'
# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the ranked videos once status is succeeded.YouTube Trending Videos API Use Cases
- Daily trend briefings for a market: Pull the news and sports pages for one country each morning and hand editors the ranked titles, channels and view counts that are breaking out.
- Tracking what trends in gaming: Follow the gaming page across the countries you publish in to spot the games, formats and creators rising before you plan videos or campaigns.
- Comparing one category across countries: Send the same category to the YouTube Trending Videos API with several region codes and line up the lists by video ID to see which videos travel and which stay local.
- Building a list of channels to contact: Collect the channels that keep reaching a category's trending page, with their handles and verified badges, as a starting list for partnerships.
YouTube Trending Videos API Pro Tips
- Schedule the YouTube Trending Videos API for the same category and region at a fixed time and join runs on id; a changing rank shows which videos are climbing and which are fading.
- Read published_time_text together with collected_at: the page shows age as text such as 15 min ago, so subtract it from the collection time when you need an approximate upload time.
- Set results_limit to 10 or 20 when you only need the top of the list; the YouTube Trending Videos API charges per returned video.
- Pass the IDs you collect to the YouTube Videos API for likes, comments and the full description, or to the YouTube Transcripts API to read what each trending video says.
Related APIs
Beyond the YouTube Trending Videos API, use these APIs when you need a different type of public YouTube data.
- YouTube Channel Videos API — Collect regular public videos from channel URLs, excluding Shorts and live streams.
- YouTube Comments API — Collect public comments, authors, engagement, source videos, and conversation context.
- YouTube Transcripts API — Retrieve available plain-text transcripts with optional language selection.
- YouTube Channels API — Retrieve public channel identity, images, verification, and visible audience statistics.
- YouTube Videos API — Retrieve metadata, thumbnails, duration, and engagement for known video or Short URLs.
- YouTube Shorts API — Collect public Shorts, thumbnails, duration, publication details, and engagement by channel.
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API