/node-hitomi

Hitomi.la api for Node.js

Primary LanguageTypeScriptMIT LicenseMIT

banner

Hitomi.la api for Node.js

Would you call me a gentleman?

npm version npm type definition license


Installation

NOTICE: Please always use the latest version of the package.
Since Hitomi changes its method to get image url often, legacy version may not work.

Using npm:

$ npm install node-hitomi

Using yarn:

$ yarn add node-hitomi

Features

  • Get gellary ids by title, tags, and popularity
  • Get gallary data by id
  • Parse, query and get tags
  • Get hitomi-related uris

Without any dependencies!

Usage/Examples

setup:

// CommonJS
const hitomi = require('node-hitomi').default;

// ES Module
import hitomi from 'node-hitomi';

printing title and id of gallery id x:

hitomi.getGallery(x)
.then(function (gallery) {
	console.log(gallery['title']['display'], gallery['id']);

	return;
});

printing supported tags of female starts with letter y:

hitomi.getTags('female', {
	startsWith: 'y'
})
.then(function (tags) {
	console.log(tags);

	return;
});

printing number of gallery with language korean without female tag netorare:

hitomi.getGalleryIds({
	tags: hitomi.getParsedTags('language:korean -female:netorare')
})
.then(function (ids) {
	console.log(ids['length']);

	return;
});

Contribution

Contribution, issues and feature requests are welcome!
Feel free to check issues page.