Nekosia.js is a Node.js module that provides easy access to the Nekosia API, a rich source of anime-themed images. The API offers a wide range of categories, allowing you to quickly and flexibly search for images based on your preferences and needs. You have full control over the images you retrieve, which sets our API apart from others.

But that's not all! The API also supports sessions (based on user ID or IP address), helping to prevent repeated images.

• Wide range of categories: Nekosia API offers virtually every kind of anime graphic, not just neko images.
• High image quality: All images are carefully selected and checked for both quality and appropriateness.
• Sessions: The API supports sessions (based on ID or IP address), helping to avoid duplicate images.
• Dominant colors: The API returns a palette of dominant colors for each image.
• Image compression: JSON responses include a link to a compressed image with a significantly reduced file size compared to the original. This ensures faster load times on client devices without sacrificing quality.
• Security: Nekosia API guarantees that all content is free from NSFW material, making it one of the most trusted sources for anime-themed images.

...and that’s not all!

Nekosia also offers its own Booru, allowing you to browse images returned by the API.
Users can edit image information, such as tags, which are crucial for us.

Check out the official documentation to learn more.

To install the Nekosia.js module, use the following command:

npm install nekosia.js

You can find the main image categories here. The full list of tags is available on the Booru site.

const { NekosiaAPI } = require('nekosia.js');

(async () => {
	const response1 = await NekosiaAPI.fetchCategoryImages('catgirl');
	console.log(response1);
	
	const response2 = await NekosiaAPI.fetchImages({ session: 'ip', count: 1, tags: ['cute', 'blue-hair'], blacklist: ['yellow-hair'] });
	console.log(response2);
	
	// https://nekosia.cat/documentation?page=api-endpoints#example-response
})();

In this example, we used an IP-based session. What does this mean? Thanks to this solution, a user with a specific IP address will not encounter duplicate images when selecting them randomly.

const { NekosiaAPI } = require('nekosia.js');

(async () => {
	const response = await NekosiaAPI.fetchCategoryImages('catgirl', {
		session: 'ip',
		count: 1,
		additionalTags: [],
		blacklistedTags: []
	});

	console.log(response);
})();

You can also use id, but this requires providing a user identifier (e.g., from Discord). Pass this information in id as a string.

const { NekosiaAPI } = require('nekosia.js');

(async () => {
	const response = await NekosiaAPI.fetchCategoryImages('catgirl', {
		session: 'id',
		id: '561621386765971781',
		count: 1,
		additionalTags: [],
		blacklistedTags: []
	});

	console.log(response);
})();

https://github.com/Nekosia-API/nekosia.js/tree/main/examples

const { NekosiaAPI } = require('nekosia.js');

(async () => {
	console.log(await NekosiaAPI.fetchTags()); // Simply returns all available tags, etc.
})();

const { NekosiaVersion } = require('nekosia.js');

(async () => {
	console.log(NekosiaVersion.module); // Returns the installed module version
	console.log(await NekosiaVersion.api()); // Returns the current API version used by the module
})();

If you find the API or this module useful, consider giving a star to the repository.
If you have any questions or issues, create a new Issue or join the Discord server.

Copyright 2024 © by Sefinek. All rights reserved.