documentation/Search-operators.md

title	description	published	date	tags	editor	dateCreated
Search-operators		true	2021-02-25T18:05:33.606Z		markdown	2021-01-28T20:40:22.456Z

Invidious supports the various search filters provided by YouTube.

Support for more user-friendly search is planned, see #179.

Search filters are currently implemented as key:value operators, similar to DuckDuckGo and other search engines. Operators can be added to the search query to filter results, for example: type:playlist sort:views music.

When using subscriptions:true or channel:UCxxx other filters are not applied.

Supported operators:

• sort:
  • relevance (default)
  • rating
  • upload_date, date
  • view_count, views
• date:
  • hour
  • today
  • week
  • month
  • year
• type:
  • all (default)
  • video
  • channel
  • playlist
  • movie
  • show
• duration:
  • short
  • long
• features: Multiple can be specified, for example features:live,4k,subtitles
  • hd
  • subtitles
  • creative_commons,cc
  • live, livestream
  • purchased
  • 4k
  • 360
  • location
  • hdr
• channel:, user:
  • UCxxxxxxxxxxxxxxxxxxxxxx
  • author Can be ambiguous, so using UCID is recommended
• subscriptions: If logged in, search only for videos from subscribed channels
  • true
  • false