Skip to main content
GET
cURL
🪙3 creditsper request

Copy for AI

🤖 Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

search_query
string
required

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

language_code
string
default:en-US

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)

country_code
string
default:US

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)

time_zone
string
default:America/Los_Angeles

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

filter_mixed_content
boolean
default:true

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
string

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_by
string

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

continuation_token
string

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

Response

The response is of type object.