danbooru

danbooru-node

danbooru api wrapper

My api wrapper is super simple! First, you require it:

var Danbooru = require('danbooru');

Then you just refer to Danbooru's lovely api documentation and make requests!

Making requests

Danbooru.get('posts', {limit: 5, tags: 'cat_ears'}, function(err, data) {
    if(err) throw err;
    console.log(data); // All of your cute kittehgirls!
});

You can also use Danbooru.post(), Danbooru.put(), and Danbooru.delete(). They all have the same parameters and give you the same callback!

Danbooru.method([path], [params], [callback])

Perform a http request on Danbooru's api!

• method property. One of get, post, put, or delete, depending on what type of request you would like to make.
• path string. The API documentation mentions a base URL. You put that here! The slash and .json are optional. In fact, the entire thing is optional, but you won't get anything useful from omitting path.
• params object. Just provide your parameters as an object!
• callback function(err, data). What do you wannya do after you get your api request?
  • err Error. Node.js callbacks always give you an error for some reason. Here you go!
  • data object. Parsing JSON output is an extra step, so you don't hafta do it! Here's an already-parsed object for you!

Authentication

You know what's a pain? Having to type the same stuff over and over again. You know what you hafta do if you want to be authenticated on Danbooru? Send your login and api_key over and over again.

var authedBooru = new Danbooru({login: 'topsecret', api_key: 'evenmoresecret'});
authedBooru.post('favorites', {post_id: 2288637}, function(err, data) {
    if(err) throw err;
    console.log('Successfully favorited!'); // Wow, you do like kittehgirls!
});

If that's still too much typing for you, you can use a shortcut!

var shortBooru = Danbooru('topsecret', 'evenmoresecret');

[new] Danbooru([object], [api_key])

Save parameters for later. Returns a new Danbooru object that you can use to make requests with those saved parameters.

• object object. string. If you provide an object, it'll be used as default parameters for all requests you make! If you provide a string, it'll set your default login parameter to whatever you provide! If you provide neither, you'll create a new, empty Danbooru object.
• api_key string. If (and only if) you provided a string for object, this will be used as your default api_key parameter!

Searching

"But wait," you say, "APIs are supposed to help make my life easier! Why do I still have to type so much?" Well, I made a helper function called search for you, and as a bonus, its data object even gives you extra helper functions to get around more easily!

Danbooru.search('1girl fox_ears', function(err, page1) {
    if(err) throw err;
    console.log(page1); // Foxgirls!

    page1.next(function(err, page2) {
        if(err) throw err;
        console.log(page2); // More foxgirls!

        page2.next(function(err, page3) {
            if(err) throw err;
            console.log(page3); // So many foxgirls~ ♥
        });
    });
});

It might be a lot of callback nesting, but you can easily get around that with a nice package like async or something that converts callbacks to promises, right? You might notice that I use LiveScript, which has a really nice way of dealing with callback nesting. I know some other languages have their own methods too, so you might wannya try one or some of them!

Danbooru.search([tags], [params], [callback])

Perform a search on Danbooru. A shortcut for Danbooru.get('posts', {tags: tags, limit: 100, ...params}, callback), but also adds on extra methods to the data object you get. Visit an api result in your browser to inspect the data object returned.

• tags string. A space separated list of tags, and basically your Danbooru search query. You can try out your query visually on Danbooru or look up their searching reference if you're not sure what to type.
• params object. These are just parameters that will be directly passed to Danbooru's API. It will contain limit: 100 by default, but you can change the number of posts you want by specifying it. Trying to specify tags won't do anything, because the tags parameter always overwrites the value of tags here, even if tags is empty or missing (which makes it default to empty).
• callback function(err, searchData) Do something after your request comes back.
  • err Error. Like always, an error object if there was one.
  • data Object. Whatever Danbooru's API returns, but with some extra methods and properties. More details below!

Danbooru.search() > callback data

Like I've said probably three times already, this data object is the one that Danbooru's api gives you, but with some nice helper functions! You can see sample API output by visiting Danbooru. I haven't told you what the methods are yet, so~

searchData.page

This is a property that tells you what your current page number is. You can't change it.

searchData.load([page], [callback])

Calls Danbooru.search() again with the same tags and parameters as last time, but with the page of results you want! Trying to load a page number less than 1 will just set it to 1.

• page number. What page of results would you like? Defaults to your current page, so you can actually use searchData.load(callback) to refresh your data.
• callback function(err, searchData). This literally gives you the same type of object as the searchData you're currently looking at.

searchData.next([modifier], [callback])

Calls searchData.load(this.page + modifier, callback), which basically increases your page number by your specified modifier. This will usually give you older posts (unless you specify a negative modifier for some reason).

• modifier number. What number would you like to increment your page number by?
• callback function(err, searchData). Same as above.

searchData.prev([modifier], [callback])

Calls searchData.load(this.page - modifier, callback), which basically decreases your page number by your specified modifier. This will usually give you newer posts (unless you specify a negative modifier for some reason).

• modifier number. What number would you like to decrement your page number by?
• callback function(err, searchData). Same as above.

searchData.tags

This is a property that tells you what tags your search is currently for. You can't change it.

searchData.add([tagMod], [callback])

Calls Danbooru.search() again with the same parameters as last time, but with your tagMod added to the end of your tags and page set back to 1.

• tagMod string. This basically just takes your current tags and then adds these tags to it. In other words, effectively Danbooru.search(searchData.tags + " " + tagMod, params, callback).
• callback function(err, searchData). Meow.

searchData.add([tagMod], [callback])

Calls Danbooru.search() again with the same parameters as last time, removing the tags in your tagMod from tags and page set back to 1.

• tagMod string. This list of tags is separated by spaces, and then any tags here are removed from your tags for your new search.
• callback function(err, searchData). Nyaa.