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

1.4 KiB

Search filters

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
    • 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