YouTube YouTube Shorts search API

Search keyword, used to match Shorts video titles, descriptions, and tags

Language/display language preference, affects the language bias of returned content. Default: en-US Impact: influences the recommendation algorithm, matching, and ranking Options: "zh-CN", "en-US", "ja-JP", "ko-KR", etc. (IETF BCP 47 standard language codes)

Region/country code, affects the regional distribution and content availability of results. Default: US Note: some Shorts content may be region-restricted Options: US, CN, JP, KR, GB, DE, FR, CA, etc. (ISO 3166-1 alpha-2 standard country codes)

Timezone, affects the calculation of time-based filters such as "today" and "this week". Default: America/Los_Angeles Impact: when upload_time is used, determines the exact date range for time periods like "today" Options: any IANA timezone database identifier "America/Los_Angeles" - US Pacific Time "America/New_York" - US Eastern Time "Asia/Shanghai" - China Standard Time "Asia/Tokyo" - Japan Standard Time "Europe/London" - UK Time "Europe/Paris" - Central European Time

Whether to automatically filter out long videos (non-Shorts content) from the response. Default: true true - automatically filter out long videos, return only Shorts recommendations false - return raw data, may include long videos Usage: true: use when you only want Shorts content (recommended for first-time use) false: use when you need YouTube's original raw response for debugging or custom processing Note: only affects the first request; continuation_token-based requests always return only Shorts

Upload time filter for Shorts, returns only videos uploaded within the specified time period. Default: null (no filter) Options: hour - uploaded in the last hour today - uploaded today (determined by time_zone setting) week - uploaded this week (last 7 days) month - uploaded this month (last 30 days) year - uploaded this year (last 365 days) Use case: find the latest trending Shorts Note: use together with time_zone; the time range depends on the configured timezone

Sort order for results. Default: null (YouTube default algorithm order) Options: relevance - most relevant (YouTube default algorithm) upload_date - by upload date (newest first) view_count - by view count (most viewed first) rating - by rating (highest rated first) Usage: relevance: find the most related content upload_date: find the most recently published Shorts view_count: find the most popular Shorts rating: find the highest-rated Shorts Priority: sort_by takes precedence over upload_time; when both are used, sort_by applies

Pagination token for retrieving the next page of results. Default: null (retrieve first page) How to obtain: taken from the previous response (look for "pagination token" fields) Notes: Token validity: typically valid for a few hours When using continuation_token, the search_query must remain the same as in the first request Using the token automatically filters duplicate Shorts content Usage: First request: set filters and parameters, retrieve the first page Subsequent pages: use the token from the previous response to retrieve the next page