youtube/
trending-videos

The YouTube Trending Videos API returns the trending videos of a category such as news, gaming or sports for any country, ranked, with channel, view count, length and thumbnail.

YouTube Trending Videos API

7 categories
Any country
Rank order
0.5 credits / result
Ready
README

By SocQ · Updated

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

ParametersRequiredDescription
categoryRequiredTrending page to read: news, gaming, sports, learning, courses, fashion or shopping.
regionOptionalTwo-letter country code of the trending page, such as US, GB or JP. Defaults to US.
results_limitOptionalHow 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.

  1. POST {"category": "news", "region": "US", "results_limit": 50} to /v1/youtube/trending-videos and keep the task_id.
  2. Call GET /v1/tasks/{task_id} every few seconds until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine YouTube data with public data from other supported social platforms.

YouTube Trending Videos API — FAQ

YouTube Trending Videos API is a programmatic interface for collecting the trending videos of a YouTube category, such as news, gaming or sports, for a chosen country. It returns each video's rank, title, channel, view count, length, thumbnail and how long ago it was posted.

In July 2025 YouTube replaced its single Trending page with trending lists for individual categories, with gaming trends kept on the Gaming explore page. The YouTube Trending Videos API reads those category pages, so you choose the category you want to follow.

Set region to the country's two-letter code, for example JP for Japan or DE for Germany. Each country has its own list, so the same category can rank different videos in each market.

News, gaming, sports, learning, courses, fashion and shopping. Send one category per task and run several tasks to cover more of them.

Up to 50 from the top of the list, set with results_limit. A category with a shorter list returns the videos it has, and you pay only for the rows you receive.

The YouTube Trending Videos API charges 0.5 credits for each returned video, so a full list of 50 costs 25 credits and the top 10 cost 5.