Searching is largely based on tags, with a number of special keywords available that allow searching based on properties of the posts.
tagname
Returns posts that are tagged with "tagname".
tagname othertagname
Returns posts that are tagged with "tagname" and "othertagname".
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.
-tagname
Returns posts that are not tagged with "tagname".
-tagname -othertagname
Returns posts that are not tagged with "tagname" and "othertagname". This is different than without the negative sign, as posts with "tagname" or "othertagname" can still be returned as long as the other one is not present.
tagname -othertagname
Returns posts that are tagged with "tagname", but are not tagged with "othertagname".
Wildcard searches are possible as well using * for "any one, more, or none" and ? for "any one".
tagn*
Returns posts that are tagged with "tagname", "tagnot", or anything else that starts with "tagn".
tagn?me
Returns posts that are tagged with "tagname", "tagnome", or anything else that starts with "tagn", has one character, and ends with "me".
tags=1
Returns posts with exactly 1 tag.
tags>0
Returns posts with 1 or more tags.
Can use <, <=, >, >=, or =.
Search for posts by aspect ratio
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.
Can use <, <=, >, >=, or =. The relation is calculated by dividing width by height.
Search for posts by file size
filesize=1
Returns posts exactly 1 byte in size.
filesize>100mb
Returns posts greater than 100 megabytes in size.
Can use <, <=, >, >=, or =. Supported suffixes are kb, mb, and gb. Uses multiples of 1024.
Search for posts by MD5 hash
hash=0D3512CAA964B2BA5D7851AF5951F33B
Returns post with an MD5 hash 0D3512CAA964B2BA5D7851AF5951F33B.
Search for posts by file name
filename=picasso.jpg
Returns posts that are named "picasso.jpg".
Search for posts by source
source=http://google.com/
Returns posts with a source of "http://google.com/".
source=any
Returns posts with a source set.
source=none
Returns posts without a source set.
Search for posts by date posted.
posted>=07-19-2019
Returns posts posted on or after 07-19-2019.
Can use <, <=, >, >=, or =. Date format is mm-dd-yyyy. Date posted includes time component, so = will not work unless the time is exact.
Search for posts by length.
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.
Can use <, <=, >, >=, or =. 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.
Search for posts by dimensions
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.
Can use <, <=, >, >=, or =.
Search for posts by ID
id=1234
Find the 1234th thing uploaded.
id>1234
Find more recently posted things
Can use <, <=, >, >=, or =.
Sorting search results can be done using the pattern order:field_direction. _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.
These fields are supported:
- id
- width
- height
- filesize
- filename
Limit the number of search results
limit=100
Only returns the first 100 results.
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.
Search for posts based on whether the content is in a lossless format.
lossless:true
Returns posts that are in a lossless format.
These search terms depend on the posts being scanned for media content. Automatic scanning was implemented in mid-2019, so posts uploaded before, or posts uploaded on a system without ffmpeg, will require additional scanning before this will work.
Search for posts containing a certain number of comments, or comments by a particular individual.
comments=1
Returns posts with exactly 1 comment.
comments>0
Returns posts with 1 or more comments.
Can use <, <=, >, >=, or =.
commented_by:username
Returns posts that have been commented on by "username".
commented_by_userno:123
Returns posts that have been commented on by user 123.
Search for posts by extension
ext=jpg
Returns posts with the extension "jpg".
- 3gpp
- ani
- asf
- avi
- bmp
- cbz
- flv
- gif
- ico
- ico
- ico
- jpg
- jxl
- mkv
- mov
- mp3
- mp4
- mpg
- ogv
- png
- stl
- svg
- swf
- tif
- ts
- webm
- webp
- zip
Search for posts by MIME type
mime=image/jpeg
Returns posts that have the MIME type "image/jpeg".
- application/riff+ani
- application/vnd.comicbook+zip
- application/x-shockwave-flash
- application/zip
- audio/mpeg
- image/gif
- image/jpeg
- image/jxl
- image/png
- image/svg+xml
- image/tiff
- image/vnd.microsoft.icon
- image/webp
- image/x-icon
- image/x-ms-bmp
- image/x-win-bitmap
- model/stl
- video/3gpp
- video/mp2t
- video/mp4
- video/mpeg
- video/ogg
- video/quicktime
- video/webm
- video/x-flv
- video/x-matroska
- video/x-ms-asf
- video/x-msvideo
Search for posts posted by particular individuals.
poster=username
Returns posts posted by "username".
poster_id=123
Returns posts posted by user 123.
Search for posts that have been marked as similar to a particular post.
similar=123
Returns posts that have been marked as similar to post 123.
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
Can use <, <=, >, >=, or =.
favorited_by:username
Returns posts that have been favorited by "username".
favorited_by_userno:123
Returns posts that have been favorited by user 123.
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".
upvoted_by_id=123
Returns posts upvoted by user 123.
downvoted_by=username
Returns posts downvoted by "username".
downvoted_by_id=123
Returns posts downvoted by user 123.
order:score_desc
Sorts the search results by score, descending.
order:score_asc
Sorts the search results by score, ascending.
Search for posts that are private/public.
private:yes
Returns posts that are private, restricted to yourself if you are not an admin.
private:no
Returns posts that are public.
Search for posts with one or more possible ratings.
rating:
Returns posts with the rating.
Ratings can be abbreviated to a single letter as well
rating:
Returns posts with the rating.
If abbreviations are used, multiple ratings can be searched for.
rating:
Returns posts with the or rating.
Available ratings:
| Name | Search Term | Abbreviation | Description |
|---|---|---|---|
| Nudity | nudity | n | Exposure of sexual characteristics |
| Sexuality | sexuality | s | The depiction of sexual activity |
| Violence | violence | v | The depiction of coercive activity |
| Provocativeness | provocativeness | p | The degree to which the image is designed to provoke arousal |
Search for posts containing a certain number of tags with the specified tag category.
persontags=1
Returns posts with exactly 1 tag with the tag category "person".
cattags>0
Returns posts with 1 or more tags with the tag category "cat".
Can use <, <=, >, >=, or =.
Category name is not case sensitive, category must exist for search to work.
wallpaper_for:username
Returns posts that are in "username"'s wallpaper pool.
wallpaper_for_userno:123
Returns posts that are in user 123's wallpaper pool.