2021-01-28 16:04:37 -05:00
---
title: Search-operators
description:
published: true
date: 2021-01-28T21:01:02.566Z
tags:
editor: undefined
dateCreated: 2021-01-28T20:40:22.456Z
---
2019-05-18 19:11:05 -04:00
Invidious supports the various search filters provided by YouTube.
2019-05-18 19:06:07 -04:00
2020-08-25 07:46:58 -04:00
Support for more user-friendly search is planned, see [#179 ](https://github.com/iv-org/invidious/issues/179 ).
2019-05-18 19:06:07 -04:00
Search filters are currently implemented as `key:value` operators, similar to [DuckDuckGo ](https://help.duckduckgo.com/duckduckgo-help-pages/results/syntax/ ) and other search engines. Operators can be added to the search query to filter results, for example: [`type:playlist sort:views music` ](https://invidio.us/search?q=type%3Aplaylist+sort%3Adate+music ).
2019-08-04 14:11:44 -04:00
When using `subscriptions:true` or `channel:UCxxx` other filters are not applied.
2019-05-18 19:06:07 -04:00
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`
