General
Searching is largely based on tags, with a number of special keywords available that allow searching based on properties of the images.
tagname
Returns images that are tagged with "tagname".
tagname othertagname
Returns images 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 images that do not match something.
-tagname
Returns images that are not tagged with "tagname".
-tagname -othertagname
Returns images that are not tagged with "tagname" and "othertagname". This is different than without the negative sign, as images with "tagname" or "othertagname" can still be returned as long as the other one is not present.
tagname -othertagname
Returns images 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 images that are tagged with "tagname", "tagnot", or anything else that starts with "tagn".
tagn?me
Returns images that are tagged with "tagname", "tagnome", or anything else that starts with "tagn", has one character, and ends with "me".
tags=1
Returns images with exactly 1 tag.
tags>0
Returns images with 1 or more tags.
Can use <, <=, >, >=, or =.
Search for images by aspect ratio
ratio=4:3
Returns images with an aspect ratio of 4:3.
ratio>16:9
Returns images with an aspect ratio greater than 16:9.
Can use <, <=, >, >=, or =. The relation is calculated by dividing width by height.
Search for images by file size
filesize=1
Returns images exactly 1 byte in size.
filesize>100mb
Returns images greater than 100 megabytes in size.
Can use <, <=, >, >=, or =. Supported suffixes are kb, mb, and gb. Uses multiples of 1024.
Search for images by MD5 hash
hash=0D3512CAA964B2BA5D7851AF5951F33B
Returns image with an MD5 hash 0D3512CAA964B2BA5D7851AF5951F33B.
Search for images by file type
filetype=jpg
Returns images that are of type "jpg".
Search for images by file name
filename=picasso.jpg
Returns images that are named "picasso.jpg".
Search for images by source
source=http://google.com/
Returns images with a source of "http://google.com/".
source=any
Returns images with a source set.
source=none
Returns images without a source set.
Search for images by date posted.
posted>=07-19-2019
Returns images 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 images by image dimensions
size=640x480
Returns images exactly 640 pixels wide by 480 pixels high.
size>1920x1080
Returns images with a width larger than 1920 and a height larger than 1080.
width=1000
Returns images exactly 1000 pixels wide.
height=1000
Returns images exactly 1000 pixels high.
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 images sorted by ID, smallest first.
order:width_desc
Returns images sorted by width, largest first.
These fields are supported:
- id
- width
- height
- filesize
- filename
Media
Search for items based on the type of media.
content:audio
Returns items that contain audio, including videos and audio files.
content:video
Returns items that contain video, including animated GIFs.
These search terms depend on the items being scanned for media content. Automatic scanning was implemented in mid-2019, so items uploaded before, or items uploaded on a system without ffmpeg, will require additional scanning before this will work.
Comments
Search for images containing a certain number of comments, or comments by a particular individual.
comments=1
Returns images with exactly 1 comment.
comments>0
Returns images with 1 or more comments.
Can use <, <=, >, >=, or =.
commented_by:username
Returns images that have been commented on by "username".
commented_by_userno:123
Returns images that have been commented on by user 123.
Users
Search for images posted by particular individuals.
poster=username
Returns images posted by "username".
poster_id=123
Returns images posted by user 123.
Favorites
Search for images that have been favorited a certain number of times, or favorited by a particular individual.
favorites=1
Returns images that have been favorited once.
favorites>0
Returns images that have been favorited 1 or more times
Can use <, <=, >, >=, or =.
favorited_by:username
Returns images that have been favorited by "username".
favorited_by_userno:123
Returns images that have been favorited by user 123.
Ratings
Search for images with one or more possible ratings.
rating:safe
Returns images with the Safe rating.
Ratings can be abbreviated to a single letter as well
rating:s
Returns images with the Safe rating.
If abbreviations are used, multiple ratings can be searched for.
rating:sq
Returns images with the Safe or Questionable rating.
Available ratings:
| Name | Search Term | Abbreviation |
|---|---|---|
| Safe | safe | s |
| Questionable | questionable | q |
| Weak | weak | w |
| Explicit | explicit | e |
| Unrated | unrated | ? |
Relationships
Search for images that have parent/child relationships.
parent=any
Returns images that have a parent.
parent=none
Returns images that have no parent.
parent=123
Returns images that have image 123 set as parent.
child=any
Returns images that have at least 1 child.
child=none
Returns images that have no children.
Tag Categories
Search for images containing a certain number of tags with the specified tag category.
persontags=1
Returns images with exactly 1 tag with the tag category "person".
cattags>0
Returns images 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.