`booru`

A node package to search boorus

npm GitHub

Features

Search 17 different boorus (check sites.json)
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 safebooru.org)
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

Installation

npm add booru
# or
yarn add booru

Usage

const Booru = require('booru')

Booru.search('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')

sb.search(['cat', 'dog'], { limit: 2 })

See example.js for more examples

Docs

Available here: https://booru.js.org

FAQ

What are the properties of a `Post`?

The basic structure of a Post object looks like:

Post {
  _data: {/*...*/},                       // The raw data from the booru
  fileUrl: 'https://aaaa.com/img.jpg',    // 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: 'https://ex.com/aaa.png',       // 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
}