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 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 by extension
ext=jpg
Returns posts with the extension "jpg".
- avif
- gif
- jpg
- png
- webp
Search for posts by MIME type
mime=image/jpeg
Returns posts that have the MIME type "image/jpeg".
- image/avif
- image/gif
- image/jpeg
- image/png
- image/webp
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.
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.
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 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".
notes_by_user_id=123
Returns posts with note(s) by user 123.
Search for posts that are in a pool.
pool=1Returns posts in pool #1.
pool=anyReturns posts in any pool.
pool=noneReturns posts not in any pool.
pool_by_name=swimmingReturns posts in the "swimming" pool.
pool_by_name=swimming_poolReturns posts in the "swimming pool" pool. Note that the underscore becomes a space.
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 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.
Search for posts posted by particular individuals.
poster=usernameReturns posts posted by "username".
poster_id=123Returns posts posted by user 123.