Comments
Search for posts containing a certain number of comments, or comments by a particular individual.
comments>0
Returns posts with 1 or more comments
Can use <, <=, >, >=, or =.
commented_by:username
Returns posts that have been commented on by "username".
Favorites
Search for posts that have been favorited a certain number of times, or favorited by a particular individual.
favorites=1
Returns posts that have been favorited once
favorites>0
Returns posts that have been favorited 1 or more times
favorited_by:username
Returns posts that have been favorited by a user
File Types
Search for posts by extension
ext=jpg
Returns posts with the extension 'jpg'
These extensions are available in the system:
- jpg, gif, png, webp, avif, svg, asf, avi, flv, mkv, mp4, ogv, mov, webm
Search for posts by MIME type
mime=image/jpeg
Returns posts that have the MIME type 'image/jpeg'
These MIME types are available in the system:
- image/jpeg, image/gif, image/png, image/webp, image/avif, image/svg+xml, video/x-ms-asf, video/x-msvideo, video/x-flv, video/x-matroska, video/mp4, video/ogg, video/quicktime, video/webm
General
Tag Searching
Searching is largely based on tags, with a number of special keywords available that allow searching based on properties of the posts.
tag_name
Returns posts that are tagged with "tag_name".
tag_name other_tag_name
Returns posts that are tagged with "tag_name" and "other_tag_name".
Most tags and keywords can be prefaced with a negative sign (-) to indicate that you want to search for posts that do not match something.
-tag_name
Returns posts that are not tagged with "tagname".
-tag_name -other_tag_name
Returns posts that are not tagged with "tag_name" or "other_tag_name".
tag_name -other_tag_name
Returns posts that are tagged with "tag_name", but are not tagged with "other_tag_name".
Wildcard searches are possible as well using *.
tag*
Returns posts that are tagged with "tag", "tags", "tagme", "tag_name", or anything else that starts with "tag".
*name
Returns posts that are tagged with "name", "tag_name", "other_tag_name" or anything else that ends with "name".
Comparing values (<, <=, >, >=, or =)
For example, you can use this to count tags.
tags=1
Returns posts with exactly 1 tag.
tags>0
Returns posts with 1 or more tags.
Searching for posts by aspect ratio.
The relation is calculated as: width / height.
ratio=4:3
Returns posts with an aspect ratio of 4:3.
ratio>16:9
Returns posts with an aspect ratio greater than 16:9.
Searching by dimentions.
size=640x480
Returns posts exactly 640 pixels wide by 480 pixels high.
size>1920x1080
Returns posts with a width larger than 1920 and a height larger than 1080.
width=1000
Returns posts exactly 1000 pixels wide.
height=1000
Returns posts exactly 1000 pixels high.
Searching by file size.
Supported suffixes are kb, mb, and gb. Uses multiples of 1024.
filesize=1
Returns posts exactly 1 byte in size
filesize>100mb
Returns posts greater than 100 megabytes in size.
Searching by date posted.
Date format is yyyy-mm-dd. Date posted includes time component, so = will not work unless the time is exact.
posted>=2019-07-19
Returns posts posted on or after 2019-07-19.
Searching posts by media length.
Available suffixes are ms, s, m, h, d, and y. A number by itself will be interpreted as milliseconds. Searches using = are not likely to work unless time is specified down to the millisecond.
length>=1h
Returns posts that are longer than an hour.
length<=10h15m
Returns posts that are shorter than 10 hours and 15 minutes.
length>=10000
Returns posts that are longer than 10,000 milliseconds, or 10 seconds.
Searching posts by ID.
id=1234
Find the 1234th thing uploaded.
id>1234
Find more recently posted things.
Post attributes.
Searching by MD5 hash.
hash=0D3512CAA964B2BA5D7851AF5951F33B
Returns post with MD5 hash 0D3512CAA964B2BA5D7851AF5951F33B.
md5=0D3512CAA964B2BA5D7851AF5951F33B
Same as above.
Searching by file name.
filename=picasso.jpg
Returns posts that are named "picasso.jpg".
Searching for posts by source.
source=https://google.com/
Returns posts with a source of "https://google.com/".
source=any
Returns posts with a source set.
source=none
Returns posts without a source set.
Sorting search results
Sorting can be done using the pattern order:field_direction.
Supported fields: id, width, height, filesize, filename.
Direction can be either asc or desc, indicating ascending (123) or descending (321) order.
order:id_asc
Returns posts sorted by ID, smallest first.
order:width_desc
Returns posts sorted by width, largest first.
Media
Search for posts based on the type of media.
content:audio
Returns posts that contain audio, including videos and audio files.
content:video
Returns posts that contain video, including animated GIFs.
Notes
Search for posts with notes.
note=noted
Returns posts with a note matching 'noted'.
notes>0
Returns posts with 1 or more notes.
Can use <, <=, >, >=, or =.
notes_by=username
Returns posts with note(s) by 'username'.
Numeric Score
Search for posts that have received numeric scores by the score or by the scorer.
score=1
Returns posts with a score of 1
score>0
Returns posts with a score of 1 or more
Can use <, <=, >, >=, or =.
upvoted_by=username
Returns posts upvoted by 'username'
downvoted_by=username
Returns posts downvoted by 'username'
order:score_desc
Returns posts ordered by score in descending order
order:score_asc
Returns posts ordered by score in ascending order
Ratings
Search for posts with one or more possible ratings.
rating:safe
Returns posts with the Safe rating.
Ratings can be abbreviated to a single letter as well.
rating:s
Returns posts with the Safe rating.
If abbreviations are used, multiple ratings can be searched for.
rating:sq
Returns posts with the Safe or Questionable rating.
Available ratings:
Name | Search Term | Abbreviation |
---|---|---|
Safe | safe | s |
Questionable | questionable | q |
Explicit | explicit | e |
Unrated | unrated | ? |
Users
Search for posts posted by particular individuals.
poster=username
Returns posts posted by "username"