documentation/docs/search-filters.md
ChunkyProgrammer bd5c262fb1
Update api documentation with new endpoints and fixes (#501)
* Fix documentation on search's `sort` parameter

* remove `news` from trending type

* Remove channels/comments documentation

* Remove channels search documentation from api.md page

* add missing endpoints

* fix `resolveurl` name

* update param description for community post comments

* update `search-filters.md` and `url-parameters.md` to include api changes
2024-06-26 10:08:11 +02:00

51 lines
1.4 KiB
Markdown

# Search filters
Invidious supports the various search filters provided by YouTube.
Support for more user-friendly search is planned, see [#179](https://github.com/iv-org/invidious/issues/179).
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).
When using `subscriptions:true` or `channel:UCxxx` other filters are not applied.
Supported operators:
- `sort:`
- `relevance` (default)
- `rating`
- `date`
- `views`
- `date:`
- `hour`
- `today`
- `week`
- `month`
- `year`
- `type:`
- `all` (default)
- `video`
- `channel`
- `playlist`
- `movie`
- `show`
- `duration:`
- `short`
- `medium`
- `long`
- `features:` Multiple can be specified, for example `features:live,4k,subtitles`
- `hd`
- `subtitles`
- `creative_commons`,`cc`
- `3d`
- `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`