Search queries are built of tokens that are separated by spaces. Each token can be of the following form:
Syntax | Token type | Description |
---|---|---|
<value> | anonymous tokens | used for basic filters |
<key>:<value> | named tokens | used for advanced filters |
sort:<style> | sort tokens | used to sort the results |
special:<value> | special tokens | used for filters tied to the logged-in user |
Most anonymous and named tokens support ranged and composite values that take the following form:
a,b,c | will show things that satisfy either a , b or c . |
1.. | will show things that are equal to or greater than 1. |
..4 | will show things that are equal to at most 4. |
1..4 | will show things that are equal to 1, 2, 3 or 4. |
Ranged values can be also supplied by appending -min
or -max
to the key, for example like this: score-min:1
.
Date/time values can be of the following form:
today
yesterday
<year>
<year>-<month>
<year>-<month>-<day>
Some fields, such as usernames, can take wildcards (*
).
All tokens can be negated by prepending them with -
.
Sort token values can be appended with ,asc
or ,desc
to control the sort direction, which can also be controlled by negating the whole token with -sort:field
.
You can escape special characters such as :
and -
by prepending them with a backslash: \:
.
Example
Searching for posts with the following query:
sea -fav-count:8.. uploader:Pirate
will show files tagged as sea, that were liked by less than 8 people, uploaded by user Pirate.