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