Comments
Search for posts containing a certain number of comments, or comments by a particular individual.
comments>0Returns posts with 1 or more comments
Can use <, <=, >, >=, or =.
commented_by:usernameReturns 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=1Returns posts that have been favorited once
favorites>0Returns posts that have been favorited 1 or more times
favorited_by:usernameReturns posts that have been favorited by a user
File Types
Search for posts by extension
ext=jpgReturns posts with the extension 'jpg'
These extensions are available in the system:
- zip, jpg, gif, png, webp, avif, asf, avi, flv, mkv, mp4, ogv, mov, webm
Search for posts by MIME type
mime=image/jpegReturns posts that have the MIME type 'image/jpeg'
These MIME types are available in the system:
- application/zip, image/jpeg, image/gif, image/png, image/webp, image/avif, 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_nameReturns posts that are tagged with "tag_name".
tag_name other_tag_nameReturns 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_nameReturns posts that are not tagged with "tagname".
-tag_name -other_tag_nameReturns posts that are not tagged with "tag_name" or "other_tag_name".
tag_name -other_tag_nameReturns 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".
*nameReturns 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=1Returns posts with exactly 1 tag.
tags>0Returns posts with 1 or more tags.
Searching for posts by aspect ratio.
The relation is calculated as: width / height.
ratio=4:3Returns posts with an aspect ratio of 4:3.
ratio>16:9Returns posts with an aspect ratio greater than 16:9.
Searching by dimentions.
size=640x480Returns posts exactly 640 pixels wide by 480 pixels high.
size>1920x1080Returns posts with a width larger than 1920 and a height larger than 1080.
width=1000Returns posts exactly 1000 pixels wide.
height=1000Returns posts exactly 1000 pixels high.
Searching by file size.
Supported suffixes are kb, mb, and gb. Uses multiples of 1024.
filesize=1Returns posts exactly 1 byte in size
filesize>100mbReturns 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-19Returns 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>=1hReturns posts that are longer than an hour.
length<=10h15mReturns posts that are shorter than 10 hours and 15 minutes.
length>=10000Returns posts that are longer than 10,000 milliseconds, or 10 seconds.
Searching posts by ID.
id=1234Find the 1234th thing uploaded.
id>1234Find more recently posted things.
Post attributes.
Searching by MD5 hash.
hash=0D3512CAA964B2BA5D7851AF5951F33BReturns post with MD5 hash 0D3512CAA964B2BA5D7851AF5951F33B.
md5=0D3512CAA964B2BA5D7851AF5951F33BSame as above.
Searching by file name.
filename=picasso.jpgReturns 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=anyReturns posts with a source set.
source=noneReturns 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_ascReturns posts sorted by ID, smallest first.
order:width_descReturns posts sorted by width, largest first.
Media
Search for posts based on the type of media.
content:audioReturns posts that contain audio, including videos and audio files.
content:videoReturns posts that contain video, including animated GIFs.
Numeric Score
Search for posts that have received numeric scores by the score or by the scorer.
score=1Returns posts with a score of 1
score>0Returns posts with a score of 1 or more
Can use <, <=, >, >=, or =.
upvoted_by=usernameReturns posts upvoted by 'username'
downvoted_by=usernameReturns posts downvoted by 'username'
order:score_descReturns posts ordered by score in descending order
order:score_ascReturns posts ordered by score in ascending order
Ratings
Search for posts with one or more possible ratings.
rating:safeReturns posts with the Safe rating.
Ratings can be abbreviated to a single letter as well.
rating:sReturns posts with the Safe rating.
If abbreviations are used, multiple ratings can be searched for.
rating:sqReturns posts with the Safe or Questionable rating.
Available ratings:
| Name | Search Term | Abbreviation |
|---|---|---|
| Safe | safe | s |
| Questionable | questionable | q |
| Explicit | explicit | e |
| Unrated | unrated | ? |
Relationships
Search for posts that have parent/child relationships.
parent=anyReturns posts that have a parent.
parent=noneReturns posts that have no parent.
parent=123Returns posts that have image 123 set as parent.
child=anyReturns posts that have at least 1 child.
child=noneReturns posts that have no children.
Tag Categories
Search for posts containing a certain number of tags with the specified tag category.
persontags=1Returns posts with exactly 1 tag with the tag category 'person'.
cattags>0Returns 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.
Users
Search for posts posted by particular individuals.
poster=usernameReturns posts posted by "username"