Fan Art Booru

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

File Types

Search for images by extension

ext=jpg

Returns images with the extension "jpg".

These extensions are available in the system:
  • ani
  • asf
  • avi
  • cbz
  • flv
  • gif
  • ico
  • ico
  • ico
  • jpg
  • mkv
  • mov
  • mp4
  • ogv
  • png
  • svg
  • swf
  • webm
  • webp

Search for images by MIME type

mime=image/jpeg

Returns images that have the MIME type "image/jpeg".

These MIME types are available in the system:
  • application/riff+ani
  • application/vnd.comicbook+zip
  • application/x-shockwave-flash
  • image/gif
  • image/jpeg
  • image/png
  • image/svg+xml
  • image/vnd.microsoft.icon
  • image/webp
  • image/x-icon
  • image/x-win-bitmap
  • video/mp4
  • video/ogg
  • video/quicktime
  • video/webm
  • video/x-flv
  • video/x-matroska
  • video/x-ms-asf
  • video/x-msvideo

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.

Notes

Search for images with notes.

note=noted

Returns images with a note matching "noted".

notes>0

Returns images with 1 or more notes.

Can use <, <=, >, >=, or =.

notes_by=username

Returns images with note(s) by "username".

notes_by_user_id=123

Returns images with note(s) by user 123.

Numeric Score

Search for images that have received numeric scores by the score or by the scorer.

score=1

Returns images with a score of 1.

score>0

Returns images with a score of 1 or more.

Can use <, <=, >, >=, or =.

upvoted_by=username

Returns images upvoted by "username".

upvoted_by_id=123

Returns images upvoted by user 123.

downvoted_by=username

Returns images downvoted by "username".

downvoted_by_id=123

Returns images downvoted by user 123.

order:score_desc

Sorts the search results by score, descending.

order:score_asc

Sorts the search results by score, ascending.

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:

NameSearch TermAbbreviation
Safesafes
Questionablequestionableq
Explicitexplicite
Unratedunrated?

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.