Sign in
YouTube

General Search

Search YouTube videos by keyword with optional language, upload-date, duration, and sort filters, or continue with a pagination token. Use it to discover public videos or browse additional result pages.

get/api/youtube/search/v1

Query parameters

tokenstring required

Access token for this API service.

keywordstring

Search term. Required for the first page; leave empty when using nextToken.

langstring

Optional IETF language tag for localized results, such as en-US. Leave empty to use the default language.

uploadDate'all' | 'lastHour' | 'today' | 'thisWeek' | 'thisMonth' | 'thisYear'

YouTube search upload date filter

Upload-date filter.

Available Values:

  • all: No upload-date limit
  • lastHour: Uploaded within the last hour
  • today: Uploaded today
  • thisWeek: Uploaded this week
  • thisMonth: Uploaded this month
  • thisYear: Uploaded this year
duration'all' | 'short' | 'medium' | 'long' | 'all' | 'short' | 'medium' | 'long'

YouTube search video duration filter

Video-duration filter.

Available Values:

  • all: No duration limit
  • SHORT: Short videos under 4 minutes
  • medium: Medium videos from 4 to 20 minutes
  • LONG: Long videos over 20 minutes
sortBy'relevance' | 'uploadDate' | 'viewCount' | 'rating'

YouTube search sort order

Sort order for search results.

Available Values:

  • relevance: Sort by relevance
  • uploadDate: Sort by upload date
  • viewCount: Sort by view count
  • rating: Sort by rating
nextTokenstring

Pagination token returned by the previous response. When provided, the keyword and filter parameters are ignored; very long tokens may exceed GET URL limits.

Response

OK

code0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602 required
messagestring nullable required
{"stackTrail":"paths:/api/youtube/search/v1:get:responses:200:content:application/json:schema:properties:data","oasType":"schema","type":"unknown"}
recordTimestring nullable required
requestIdstring

Changes

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