youtube/
trending-shorts

The YouTube Trending Shorts API samples the Shorts trending on YouTube right now with no input needed, returning titles, channels, views, likes, comments, duration, and exact publish times.

YouTube Trending Shorts API

No input required
Fresh sample each run
Views, likes, comments
0.5 credits / result
Ready
README

By SocQ · Updated

YouTube Trending Shorts

Trending Shorts are the vertical videos YouTube is pushing to a wide audience at the moment, each carrying its title, the channel behind it, view, like and comment counts, length and the exact time it went up. Read together, those signals show which topics, formats and creators are breaking out, and how quickly a Short collects views after it is published.

YouTube Trending Shorts API Features

  • Straight from the trending poolThere is nothing to fill in: each run draws the Shorts YouTube is promoting at that moment, about 48 per draw, and repeated draws are merged without duplicates up to results_limit.
  • Three engagement counts per Shortmetrics carries exact view and like counts alongside the comment count YouTube displays, so a Short with heavy discussion stands out from one that is only being watched.
  • Channel attached to every Shortauthor holds the channel ID, handle, name, URL and avatar, ready to pass to channel-level APIs.
  • Publish time and lengthpublished_at is the precise upload time in UTC and duration_seconds the running time, which together tell you how new and how long a trending Short is.
  • Hashtags pulled from the captionTags written in the title or description are listed in hashtags, without the leading #.

YouTube Trending Shorts API Parameters

ParametersRequiredDescription
results_limitOptionalHow many trending Shorts to return, from 1 to 200. Defaults to 48.

How to Use the YouTube Trending Shorts API

Send the YouTube Trending Shorts API an optional result count, then read the Shorts once the task finishes.

  1. POST {"results_limit": 48} to /v1/youtube/trending-shorts; the body can also be empty.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the Shorts from results.items, and follow results.next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit":48}'

# Each item is one Short with metrics.views_count and author.
# Read them from GET /v1/tasks/{task_id}.

YouTube Trending Shorts API Use Cases

  • Daily trend snapshots: Run the YouTube Trending Shorts API at set times and store each batch to see which topics and formats keep showing up in trending Shorts.
  • Spotting breakout creators: Compare views_count with published_at to find channels whose fresh uploads are pulling millions of views within days.
  • Hashtag watch for Shorts: Count the hashtags across trending Shorts to see which tags ride along with viral short-form videos this week.

YouTube Trending Shorts API Pro Tips

  • Each run is a new sample, so keep the id of every Short you store and skip repeats when you merge runs taken minutes apart.
  • Divide views_count by the hours since published_at to rank Shorts by speed rather than by total views.
  • Send author.url to YouTube Channels when you also need subscriber counts and channel descriptions.

Beyond the YouTube Trending Shorts 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 Shorts API — FAQ

YouTube Trending Shorts API is a programmatic interface for sampling the Shorts YouTube is currently promoting as trending, without any search input. It returns each Short's title, channel, view, like and comment counts, duration and publish time.

Every run draws a fresh sample from the trending pool, so runs a few minutes apart share only a handful of Shorts. Scheduling several runs and merging them by id gives a broader view of what is trending.

Set results_limit anywhere from 1 to 200; it defaults to 48, which is about one draw from the trending pool.

Views and likes are: views_count and likes_count are full integers taken from each Short. comments_count follows the figure YouTube displays, so counts above a thousand are rounded, for example 4800 for 4.8K, and likes or comments are null when a creator hides them.

There is no country parameter. Each run returns the Shorts in the trending pool at that moment, so schedule runs and merge them by id to follow how the pool changes.

The YouTube Trending Shorts API charges 0.5 credits for each Short returned, so the default 48 Shorts cost 24 credits.