Search (and do other things) on a bunch of different boorus!

  • booru

Downloads in past


6092.6.36 months ago6 years agoMinified + gzip package size for booru in KB


A node package to search boorus
CircleCI npm GitHub Typescript typings


  • Normalizes all received data into Post objects that are consistent no matter which booru you use
  • Access to the raw data received from the booru as well (transformed from XML to JSON, if applicable)
  • Alias support for boorus (sb for
  • Promises
  • Types (using Typescript)
  • Choose the amount of images to get
  • Random support for all sites, using order:random on sites that support it and using custom code on those that don't
  • Coming soon(-ish): Support for more than just searching


```sh npm add booru
yarn add booru ``` ---


```js const Booru = require('booru')'safebooru', 'glaceon', { limit: 3, random: true }).then( posts => {
for (let post of posts) console.log(post.fileUrl, post.postView)
}, ) // or (using alias support and creating boorus) const sb = Booru.forSite('sb')'cat', 'dog', { limit: 2 }) ``` See example.js for more examples ---


Available here:

Web support

booru was built for Node.js, and is only officially supported for Node.js. Issues relating to web are fine, although support might be limited. It's possible to use booru on the web using webpack (or similar), although your experience may vary. Some websites don't have the proper CORS headers, meaning that API requests to those sites from a browser will fail! This is not an issue I can fix in the package, and requires either that booru to add proper support themselves or for you to find a workaround for CORS.


What are the properties of a Post?

The basic structure of a Post object looks like: ```js Post { data: {/.../}, // The raw data from the booru fileUrl: '', // The direct link to the image, ready to post id: '124125', // The image ID, as a string tags: 'cat', 'cute', // The tags, split into an Array score: 5, // The score as a Number source: '', // Source of the image, if supplied rating: 's', // Rating of the image createdAt: Date, // The Date this image was created at postView: 'https://booru.ex/show/12345' // A URL to the post } ``` s: 'Safe' q: 'Questionable' e: 'Explicit' u: 'Unrated' Derpibooru has Safe, Suggestive, Questionable, Explicit, although Suggestive will be shown as q in <Post>.rating

Can I contribute?

Sure! Just fork this repo, push your changes, and then make a PR. I'll accept PR based on what they do and code style (Not super strict about it, but it's best if it roughly follows the rest of the code)


Why not?


It's MIT ---


Change from request-promise-native to snek-fetch
Add 2 new boorus (
Various Derpibooru fixes
Add TypeScript declarations
Improve TypeScript port
Various other small fixes
Add missing type information