API docs

Search image-board post metadata.

Loading stats…

Search

GET /v1/images?q=1girl+solo+~(smile+blush)+-comic+score:>=25&limit=50

Query

tag1 tag2
all tags
~(tag1 tag2)
any tag
-tag
exclude tag
-(tag1 tag2)
exclude any tag
score:>=25
metadata filter
rating:g
rating filter

Source

Sources: danbooru, censoredbooru, e621, and rule34. Imports and counts are shown on metrics. Rule34 and e621 start from snapshots and fetch new posts hourly.

Choose the source separately from q: source=censoredbooru, source=danbooru,censoredbooru, or source=all. Defaults to danbooru.

/v1/images?source=censoredbooru&q=rating:g&limit=30

Pagination

Newest upload first, with internal ID breaking timestamp ties. Sources are combined in this order, not import order. Rule34 uses last-change time from its snapshot.

Keep source and q unchanged when paginating.

Use limit from 1 to 100. Pass next_cursor back as cursor.

Output

{
  "items": [{
    "id": int64, // internal API ID
    "source": string,
    "post_id": int64, // ID assigned by the source site
    "created_at": RFC3339 string,
    "tags": string[],
    "score": integer,
    "rating": "g" | "s" | "q" | "e",
    "width": integer,
    "height": integer,
    "file_size": int64,
    "preview_url": string,
    "file_url": string
  }],
  "next_cursor": string
}

Endpoints

Fetch dashboard · Metrics JSON

GET /healthz
health
GET /v1/images
search
GET /v1/stats
stats
POST /v1/images/{id}/missing
report missing image