SearchingLicenses

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

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.

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.

Search for images posted by particular individuals.

poster=username

Returns images posted by "username".

poster_id=123

Returns images posted by user 123.

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.

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.