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
| Parameters | Required | Description |
|---|---|---|
query | Required | The keyword to search Shorts for, up to 100 characters. |
results_limit | Optional | How 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.
- POST {"query": "meal prep", "results_limit": 25} to /v1/youtube/search-shorts.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API