YouTube

Search YouTube

Search YouTube videos, channels, and playlists by free-text keyword (not hashtag — use youtube.search.hashtag.list for that).

get/v1/youtube/search

Request

  • Base URL: https://api.socialfetch.dev
  • URL: https://api.socialfetch.dev/v1/youtube/search
  • Auth: one of:
    • API key in header x-api-key
    • none

Query parameters

querystring required

Search query text for YouTube content.

uploadDate'today' | 'this_week' | 'this_month' | 'this_year'

Optional upload date filter for video results.

sortBy'relevance' | 'popular'

Optional sort order for search results.

type'videos' | 'shorts' | 'channels' | 'playlists'

Optional content type filter for search results.

duration'under_3_min' | 'between_3_and_20_min' | 'over_20_min'

Optional duration filter for video results. Applies to videos, not shorts.

regionstring

Optional ISO 3166-1 country code for localized search results.

cursorstring

Opaque pagination cursor returned by a previous response.

includeExtrasboolean

When true, returns richer per-video metadata when available. May increase response time.

Response

Search results for the requested query.

Changes

No recorded changes to this operation across all 1 revision of this API.