wallhaven-api

Install

yarn add wallhaven-api

Usage

const Wallhaven = require('wallhaven-api')
 
const api = new Wallhaven()
 
api.search('attack on titans')
  .then(result => {
    console.log(result)
    // => { totalPages: 29, images: [] }
  })

Micro-service

A micro-service based on this module: https://wallhaven-api.now.sh

Examples:

• Search: https://wallhaven-api.now.sh/search?keyword=attack on titans
• Details: https://wallhaven-api.now.sh/details/482373

API

api.search(keyword, [options])

Search wallpapers by given keyword.

options.categories

Type: Array
Default: ['general', 'anime', 'people']

options.page

Type: Number
Default: 1

options.sorting

Type: string
Default: relevance
Value: one of relevance random date_added views favorites

options.nsfw

Type: boolean
Default: false

Show NSFW (not safe for work) result.

options.sketchy

Type: boolean
Default: false

Show sketchy wallpapers only.

api.deatils(id)

Get the details of a wallpaper by image id.

id

Type: Number

Image ID.

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

Author

wallhaven-api © egoist, Released under the MIT License.
Authored and maintained by egoist with help from contributors (list).

egoistian.com · GitHub @egoist · Twitter @rem_rin_rin