youtube/
search-shorts

The YouTube Shorts Search API searches YouTube Shorts by keyword and returns each Short's link, caption, view count, vertical thumbnail, and caption hashtags, in YouTube's search order.

YouTube Shorts Search API

Keyword input
Shorts only
Up to 200 Shorts
0.6 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

YouTube Shorts Search

Shorts search results are the vertical videos YouTube ranks for a keyword in its Shorts filter, each shown with a caption, a view count and a 9:16 thumbnail. Looking across them shows which hooks and angles win attention on a topic and gives you a set of Short links to study or track further.

YouTube Shorts Search API Features

  • Shorts and nothing elseResults come from YouTube's Shorts search, so long-form videos, channels and playlists stay out of the list.
  • Caption, views and thumbnailtext is the Short's caption, metrics.views_count is parsed from the display count, and media holds the vertical thumbnail with its size.
  • Hashtags from the captionTags written in the caption are listed in hashtags, ready for counting across a result set.
  • Ready-to-use Shorts linksEvery result carries a youtube.com/shorts/ URL and the video ID for follow-up lookups.

YouTube Shorts Search API Parameters

ParametersRequiredDescription
queryRequiredThe keyword to search Shorts for, up to 100 characters.
results_limitOptionalHow many Shorts to return, from 1 to 200. Defaults to 25.

How to Use the YouTube Shorts Search API

Send a keyword to the YouTube Shorts Search API and read the matching Shorts.

  1. POST {"query": "meal prep", "results_limit": 25} to /v1/youtube/search-shorts.
  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/search-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"meal prep","results_limit":25}'

# Each item is one Short with text, metrics.views_count and a shorts URL.

YouTube Shorts Search API Use Cases

  • Researching hooks for a topic: Read the captions of the highest-viewed Shorts for a keyword to see which openings and promises draw views.
  • Tracking a keyword in Shorts: Repeat the same search on a schedule and compare which video IDs enter or leave the results.
  • Collecting Shorts for deeper analysis: Gather the shorts URLs for a theme and hand them to YouTube Videos for channel, like and publish-date details.

YouTube Shorts Search API Pro Tips

  • Search results carry the caption and view count only, so send the URLs you keep to YouTube Videos when you need the channel or likes.
  • View counts come from rounded display text like 635K; compare them as orders of magnitude rather than exact totals.
  • Later pages repeat some Shorts from earlier ones, so results are de-duplicated by video ID before they count toward results_limit.

Beyond the YouTube Shorts Search API, use these APIs when you need a different type of public YouTube data.

  • YouTube Comments API — Collect public comments, authors, engagement, source videos, and conversation context.
  • YouTube Videos API — Retrieve metadata, thumbnails, duration, and engagement for known video or Short URLs.
  • YouTube Search API — Search public regular videos by keyword with supported metadata filters.
  • YouTube Hashtag Search API — Find public videos from hashtag feeds with all-content or Shorts-only collection.
  • YouTube Related Videos API — List the videos recommended next to a video URL, with titles, channels, views, and thumbnails.
  • YouTube Channel Search API — Find channels by keyword, with names, subscriber counts, avatars, and description snippets.

Explore other platforms

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

YouTube Shorts Search API — FAQ

YouTube Shorts Search API is a programmatic interface for searching YouTube Shorts by keyword. It returns each Short's link, caption, view count and vertical thumbnail in YouTube's search order.

Send the Short's URL to YouTube Videos, which returns the channel, likes, comments and publish date for each video.

Set results_limit from 1 to 200; it defaults to 25, which is about one page of Shorts results.

Its search has no Shorts-only filter, and videoDuration=short matches every video under four minutes. This endpoint takes results from YouTube's Shorts search, so every item it returns is a Short.

The YouTube Shorts Search API charges 0.6 credits for each Short returned, so the default 25 Shorts cost 15 credits.