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.

tagname

Returns posts that are tagged with "tagname".

tagname othertagname

Returns posts that are tagged with "tagname" and "othertagme".


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" or "othertagname".

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".

tag*

Returns posts that are tagged with "tag", "tags", "tagme", "tagname", or anything else that starts with "tag".

*name

Returns posts that are tagged with "name", "tagname", "othertagname" or anything else that ends with "name".

tagn?me

Returns posts that are tagged with "tagname", "tagnome", or anything else that starts with "tagn", then has one character, and ends with "me".


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.


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.

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.

Comments

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.

File Types

Search for posts by extension

ext=jpg

Returns posts with the extension "jpg".

These extensions are available in the system:
  • asf
  • avi
  • flv
  • gif
  • jpg
  • mkv
  • mov
  • mp3
  • mp4
  • ogv
  • png
  • webm
  • webp

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:
  • audio/mpeg
  • image/gif
  • image/jpeg
  • image/png
  • image/webp
  • video/mp4
  • video/ogg
  • video/quicktime
  • video/webm
  • video/x-flv
  • video/x-matroska
  • video/x-ms-asf
  • video/x-msvideo

Users

Search for posts posted by particular individuals.

poster=username

Returns posts posted by "username".

poster_id=123

Returns posts posted by user 123.

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

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.

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".

notes_by_user_id=123

Returns posts with note(s) by user 123.

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".

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.

Pools

Search for posts that are in a pool.

pool=1

Returns posts in pool #1.

pool=any

Returns posts in any pool.

pool=none

Returns posts not in any pool.

pool_by_name=swimming

Returns posts in the "swimming" pool.

pool_by_name=swimming_pool

Returns posts in the "swimming pool" pool. Note that the underscore becomes a space.

Ratings

Search for posts with one or more possible ratings.

rating:unrated

Returns posts with the Unrated rating.

Ratings can be abbreviated to a single letter as well.

rating:?

Returns posts with the Unrated rating.

If abbreviations are used, multiple ratings can be searched for.

rating:?s

Returns posts with the Unrated or Safe rating.

Available ratings:

NameSearch TermAbbreviation
Unratedunrated?
Safesafes
Questionablequestionableq
Explicitexplicite

Relationships

Search for posts that have parent/child relationships.

parent=any

Returns posts that have a parent.

parent=none

Returns posts that have no parent.

parent=123

Returns posts that have image 123 set as parent.

child=any

Returns posts that have at least 1 child.

child=none

Returns posts that have no children.

Tag Categories

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.