wallhaven
wallhaven copied to clipboard
API for alpha.wallhaven.cc
wallhaven
Install
yarn add wallhaven
Usage
const Wallhaven = require('wallhaven')
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.now.sh
Examples:
- Search: https://wallhaven.now.sh/search?keyword=attack%20on%20titans
- Details: https://wallhaven.now.sh/details/482373
- Random: https://wallhaven.now.sh/random?keyword=eriri
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.details(id)
Get the details of a wallpaper by image id.
id
Type: Number
Image ID.
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request :D
Author
wallhaven © EGOIST, Released under the MIT License.
Authored and maintained by egoist with help from contributors (list).
Website · GitHub @egoist · Twitter @_egoistlily