nekosia.js 0.2.0 → 0.2.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Nekosia
+Copyright (c) 2024-2025 Nekosia
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/examples/dynamicCategoryFetch.js

@@ -1,6 +1,6 @@
 const { NekosiaAPI } = require('../index.js');
 
-const fetchImages = async (category, options = {}) => {
+const fetch = async (category, options = {}) => {
 	try {
 		const response = await NekosiaAPI.fetchCategoryImages(category, options);
 		console.log(`${category.toUpperCase()}:`, response);
@@ -10,7 +10,7 @@ const fetchImages = async (category, options = {}) => {
 };
 
 (async () => {
-	await fetchImages('catgirl');
-	await fetchImages('foxgirl', { session: 'id', id: 'user123', count: 2 });
-	await fetchImages('catgirl', { tags: 'animal-ears' });
+	await fetch('catgirl');
+	await fetch('foxgirl', { session: 'id', id: 'user123', count: 2 });
+	await fetch('catgirl', { tags: 'animal-ears' });
 })();

package/examples/fetchCategoryImages.js

@@ -4,8 +4,8 @@ const { NekosiaAPI } = require('../index.js');
 	const response = await NekosiaAPI.fetchCategoryImages('foxgirl', {
 		session: 'ip',
 		count: 1,
-		additionalTags: ['cute', 'sakura', 'cherry-blossom'],
-		blacklistedTags: ['beret'],
+		additionalTags: ['cute', 'sakura', 'blue-hair', 'blue-eyes'],
+		blacklistedTags: ['beret', 'hat'],
 	});
 
 	console.log(response);

package/examples/fetchImages.js

@@ -1,6 +1,12 @@
 const { NekosiaAPI } = require('../index.js');
 
 (async () => {
-	const response = await NekosiaAPI.fetchImages({ session: 'ip', count: 1, tags: ['cute', 'blue-hair'], blacklist: ['yellow-hair'] });
+	const response = await NekosiaAPI.fetchImages({
+		session: 'ip',
+		count: 1,
+		tags: ['cute', 'sakura', 'blue-hair', 'blue-eyes'],
+		blacklist: ['beret', 'hat'],
+	});
+
 	console.log(response);
 })();

package/index.js

@@ -27,18 +27,19 @@ class NekosiaAPI {
 
 	async fetchCategoryImages(category, options = {}) {
 		if (!category) {
-			throw new Error('The image category is required. For example, use fetchCategoryImages(\'catgirl\').');
+			throw new Error('Image category is required. For example: fetchCategoryImages(\'catgirl\')');
 		}
 
 		if (options.session && !['id', 'ip'].includes(options.session)) {
-			throw new Error('The `session` setting can contain only the following values `id` and `ip`, both as strings.');
+			throw new Error('The `session` setting can contain only the following values `id` and `ip`, both as strings');
 		}
 
 		if (!options.session && options.id) {
 			throw new Error('`id` is not required if the session is `null` or `undefined`');
 		}
 
-		return this.makeHttpRequest(`${API_URL}/images/${category}?${this.buildQueryParams(options)}`);
+		const query = this.buildQueryParams(options);
+		return this.makeHttpRequest(`${API_URL}/images/${category}${query ? `?${query}` : ''}`);
 	}
 
 	async fetchImages(options = {}) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nekosia.js",
-  "version": "0.2.0",
-  "description": "A simple wrapper for the Nekosia API that offers seamless access to random anime images. Add a touch of anime magic and feline charm to your projects, meow~~! Find out why Nekosia is the purrfect choice!",
+  "version": "0.2.1",
+  "description": "A simple wrapper for the Nekosia API that offers seamless access to random anime images. Add a touch of anime magic and feline charm to your projects, meow~! Find out why Nekosia is the purrfect choice!",
   "keywords": [
     "anime api",
     "anime art",
@@ -57,8 +57,8 @@
     "up": "ncu -u && npm install && npm update && npm audit fix"
   },
   "devDependencies": {
-    "@eslint/js": "^9.17.0",
-    "globals": "^15.13.0",
+    "@eslint/js": "^9.25.0",
+    "globals": "^16.0.0",
     "jest": "^29.7.0"
   }
 }

package/services/https.js

@@ -1,8 +1,8 @@
 const https = require('https');
-const { name, version, homepage, devDependencies } = require('../package.json');
+const { name, version, devDependencies } = require('../package.json');
 
 const headers = {
-	'User-Agent': `Mozilla/5.0 (compatible; ${name}/${version}; +${homepage})${process.env.JEST_WORKER_ID ? ` jest/${devDependencies.jest.replace(/^[^0-9]*/, '')}` : ''}`,
+	'User-Agent': `${name}/${version} (+https://github.com/Nekosia-API/nekosia.js)${process.env.JEST_WORKER_ID ? ` jest/${devDependencies.jest.replace(/^[^0-9]*/, '')}` : ''}`,
 	'Accept': 'application/json',
 	'Content-Type': 'application/json',
 	'Cache-Control': 'no-cache',
@@ -13,7 +13,7 @@ const headers = {
 const timeout = 25000;
 
 const get = async url => {
-	if (!url || typeof url !== 'string') throw new Error('Missing URL, expected a string.');
+	if (!url || typeof url !== 'string') throw new Error('Missing URL, expected a string');
 
 	return new Promise((resolve, reject) => {
 		const req = https.get(url, { headers, timeout }, res => {
@@ -41,7 +41,7 @@ const get = async url => {
 
 		req.on('timeout', () => {
 			req.destroy();
-			reject(new Error(`Request timed out after ${timeout} ms.`));
+			reject(new Error(`Request timed out after ${timeout} ms`));
 		});
 	});
 };

package/test/api.test.js

@@ -1,109 +1,134 @@
 const { NekosiaAPI } = require('../index.js');
 
-describe('NekosiaAPI (API Tests)', () => {
+const expectValidImageObject = res => {
+	expect(res.success).toBe(true);
+	expect(res.status).toBe(200);
+	expect(res).toHaveProperty('image');
+	expect(res.image.original.url).toEqual(expect.any(String));
+	expect(res.tags.length).toBeGreaterThan(0);
+};
+
+describe('nekosia.js tests', () => {
 
 	describe('fetchCategoryImages', () => {
-		it('should fetch images for the given category', async () => {
+
+		it('should fetch one image when count is 1', async () => {
 			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 1 });
+			expectValidImageObject(res);
+		});
+
+		it('should fetch multiple images when count is between 2 and 24', async () => {
+			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 3 });
 
-			expect(res).toBeInstanceOf(Object);
 			expect(res.success).toBe(true);
 			expect(res.status).toBe(200);
+			expect(Array.isArray(res.images)).toBe(true);
+			expect(res.images.length).toBe(3);
 
-			expect(res).toHaveProperty('category');
-			expect(res).toHaveProperty('id');
-			expect(res).toHaveProperty('image');
-
-			expect(res.image).toHaveProperty('original');
-			expect(res.image).toHaveProperty('compressed');
-			expect(res.image.original).toHaveProperty('url');
-			expect(res.image.original).toHaveProperty('extension');
-			expect(res.image.compressed).toHaveProperty('url');
-			expect(res.image.compressed).toHaveProperty('extension');
-
-			expect(res.metadata).toHaveProperty('original');
-			expect(res.metadata.original).toHaveProperty('width');
-			expect(res.metadata.original).toHaveProperty('height');
-			expect(res.metadata.original).toHaveProperty('size');
-			expect(res.metadata.original).toHaveProperty('extension');
-
-			expect(res.metadata).toHaveProperty('compressed');
-			expect(res.metadata.compressed).toHaveProperty('width');
-			expect(res.metadata.compressed).toHaveProperty('height');
-			expect(res.metadata.compressed).toHaveProperty('size');
-			expect(res.metadata.compressed).toHaveProperty('extension');
-
-			expect(res).toHaveProperty('tags');
-			expect(res.tags).toBeInstanceOf(Array);
-			expect(res.tags.length).toBeGreaterThan(0);
-
-			expect(res).toHaveProperty('rating');
-			expect(res).toHaveProperty('source');
-			expect(res.source).toHaveProperty('url');
+			for (const img of res.images) {
+				expect(img).toHaveProperty('image');
+				expect(img.image.original.url).toEqual(expect.any(String));
+			}
+		});
+
+		it('should fetch maximum allowed number of images (24)', async () => {
+			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 24 });
+
+			expect(res.success).toBe(true);
+			expect(res.status).toBe(200);
+			expect(Array.isArray(res.images)).toBe(true);
+			expect(res.images.length).toBe(24);
 		});
 
-		it('should return an error for an invalid category', async () => {
-			const res = await NekosiaAPI.fetchCategoryImages('invalid-category', { count: 1 });
+		it('should return error if count exceeds the maximum (25)', async () => {
+			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 25 });
 
 			expect(res.success).toBe(false);
 			expect(res.status).toBe(400);
+			expect(res.message).toMatch(/Count must be between 1 and 24/i);
 		});
 
-		it('should return a specified number of images', async () => {
-			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 3 });
-
-			expect(res).toBeInstanceOf(Object);
-			expect(res.success).toBe(true);
-			expect(res.status).toBe(200);
-			expect(res).toHaveProperty('images');
-			expect(res.images).toBeInstanceOf(Array);
-			expect(res.images.length).toBe(3);
+		it('should return error for invalid count value', async () => {
+			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 'invalid' });
+			expect(res.success).toBe(false);
+			expect(res.status).toBe(400);
 		});
-	});
 
-	describe('fetchImages', () => {
-		it('should handle no images found for nothing category with additional tags', async () => {
-			const res = await NekosiaAPI.fetchImages({ count: 1, tags: ['wTbf8J0TirS6a4fO5uyKcRazZOlO5h6o', 'xX9f9pwDAgsM3Li1LwsJ3tXQfGKW4WA0'] });
+		it('should return error for negative count', async () => {
+			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: -5 });
+			expect(res.success).toBe(false);
+			expect(res.status).toBe(400);
+		});
 
+		it('should return error for count = 0', async () => {
+			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 0 });
 			expect(res.success).toBe(false);
 			expect(res.status).toBe(400);
 		});
 
-		it('should throw an error if additionalTagsArray is empty', async () => {
-			await expect(NekosiaAPI.fetchImages([])).rejects.toThrow('`tags` must be a non-empty array');
+		it('should handle random category', async () => {
+			const res = await NekosiaAPI.fetchCategoryImages('random');
+
+			expectValidImageObject(res);
 		});
 
-		it('should return an error response for invalid count parameter', async () => {
-			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 'invalid' });
+		it('should return error for invalid category', async () => {
+			const res = await NekosiaAPI.fetchCategoryImages('invalid-category');
 			expect(res.success).toBe(false);
 			expect(res.status).toBe(400);
-			expect(res.message).toBe('Invalid count parameter. Expected a number between 1 and 48 (>48).');
 		});
 	});
 
-	describe('fetchById', () => {
-		it('should fetch an image by ID if it exists', async () => {
-			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 1 });
+	describe('fetchImages', () => {
+		it('should return error when no image matches tags', async () => {
+			const res = await NekosiaAPI.fetchImages({
+				count: 1,
+				tags: ['invalid-tag1', 'invalid-tag2'],
+			});
 
-			if (res.success && res.id) {
-				const id = res.id;
+			expect(res.success).toBe(false);
+			expect(res.status).toBe(400);
+		});
 
-				const res2 = await NekosiaAPI.fetchById(id);
-				expect(res2.success).toBe(true);
-				expect(res2.status).toBe(200);
-				expect(res2).toHaveProperty('id', id);
-				expect(res2).toHaveProperty('image');
-			} else {
-				throw new Error('No images available to fetch by ID');
-			}
+		it('should throw if tags array is empty', async () => {
+			await expect(() => NekosiaAPI.fetchImages({ tags: [] }))
+				.rejects
+				.toThrow('`tags` must be a non-empty array');
 		});
 
-		it('should return an error response for invalid ID format', async () => {
-			const res = await NekosiaAPI.fetchCategoryImages('12345');
+		it('should return a valid image for known tag', async () => {
+			const res = await NekosiaAPI.fetchImages({
+				count: 1,
+				tags: ['catgirl'],
+			});
+
+			expectValidImageObject(res);
+		});
+	});
+
+	describe('fetchById', () => {
+		it('should fetch image by ID', async () => {
+			const preview = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 1 });
+			if (!preview.success || !preview.id) throw new Error('No valid image to fetch by ID');
+
+			const fetched = await NekosiaAPI.fetchById(preview.id);
+			expect(fetched.success).toBe(true);
+			expect(fetched.status).toBe(200);
+			expect(fetched.id).toBe(preview.id);
+			expect(fetched).toHaveProperty('image');
+		});
+
+		it('should return error for malformed ID', async () => {
+			const res = await NekosiaAPI.fetchById('12345');
 			expect(res.success).toBe(false);
 			expect(res.status).toBe(400);
-			expect(res.message).toBe('No images matching the specified criteria were found. See https://nekosia.cat/documentation?page=api-endpoints#tags-and-categories');
+			expect(res.message).toMatch(/The image with the provided identifier was not found/);
 		});
-	});
 
+		it('should return error for valid format but non-existent ID', async () => {
+			const res = await NekosiaAPI.fetchById('keyboardcat');
+			expect(res.success).toBe(false);
+			expect(400).toBe(res.status);
+		});
+	});
 });

package/test/integration.test.js

@@ -14,6 +14,11 @@ describe('NekosiaAPI', () => {
 			const result = NekosiaAPI.buildQueryParams(options);
 			expect(result).toBe('count=3&additionalTags=tag1,tag2,tag3,tag4');
 		});
+
+		it('should return empty string for empty options', () => {
+			const result = NekosiaAPI.buildQueryParams({});
+			expect(result).toBe('');
+		});
 	});
 
 	describe('makeHttpRequest', () => {
@@ -54,13 +59,42 @@ describe('NekosiaAPI', () => {
 			expect(res).toEqual(mockResponse);
 			expect(https.get).toHaveBeenCalledWith(expectedEndpoint);
 		});
+
+		it('should build correct endpoint with no query params if options are empty', async () => {
+			const mockResponse = { data: { results: [] } };
+			https.get.mockResolvedValue(mockResponse);
+
+			const expectedEndpoint = 'https://api.nekosia.cat/api/v1/images/catgirl';
+			const res = await NekosiaAPI.fetchCategoryImages('catgirl');
+
+			expect(res).toEqual(mockResponse);
+			expect(https.get).toHaveBeenCalledWith(expectedEndpoint);
+		});
+
+		it('should include count=1 if explicitly set', async () => {
+			const mockResponse = { data: { results: [] } };
+			https.get.mockResolvedValue(mockResponse);
+
+			const expectedEndpoint = 'https://api.nekosia.cat/api/v1/images/catgirl?count=1';
+			const res = await NekosiaAPI.fetchCategoryImages('catgirl', { count: 1 });
+
+			expect(res).toEqual(mockResponse);
+			expect(https.get).toHaveBeenCalledWith(expectedEndpoint);
+		});
+
 	});
 
 	describe('fetchImages', () => {
-		it('should throw an error if additionalTags is empty', async () => {
+		it('should throw an error if tags is missing', async () => {
 			await expect(NekosiaAPI.fetchImages({})).rejects.toThrow('`tags` must be a non-empty array');
 		});
 
+		it('should throw an error if tags is not an array', async () => {
+			await expect(NekosiaAPI.fetchImages({ tags: 'not-an-array' }))
+				.rejects
+				.toThrow('`tags` must be a non-empty array');
+		});
+
 		it('should correctly call fetchImages with additionalTags', async () => {
 			const mockResponse = { data: { results: [] } };
 			https.get.mockResolvedValue(mockResponse);
@@ -74,8 +108,10 @@ describe('NekosiaAPI', () => {
 	});
 
 	describe('fetchById', () => {
-		it('should throw an error if id is not provided', async () => {
-			await expect(NekosiaAPI.fetchById()).rejects.toThrow('`id` parameter is required');
+		it('should throw an error if id is missing or empty', async () => {
+			for (const id of [undefined, '']) {
+				await expect(NekosiaAPI.fetchById(id)).rejects.toThrow('`id` parameter is required');
+			}
 		});
 
 		it('should correctly fetch image by ID', async () => {

package/types/index.d.ts

@@ -28,7 +28,7 @@ declare module 'nekosia.js' {
          * The number of images to fetch. WARNING! The higher the number, the more data the server will need to process, leading to longer response times.
          *
          * - Minimum - 1
-         * - Maximum - 48
+         * - Maximum - 24
          * @type Number
          * @default 1
          */
@@ -38,7 +38,7 @@ declare module 'nekosia.js' {
          * Additional tags to include in the image search.
          * This can be a single string representing one tag or an array of strings for multiple tags.
          * @type Array
-         * @example ["cute", "sakura", "cherry-blossom"]
+         * @example ["cute", "sakura", "blue-eyes"]
          * @default []
          */
         additionalTags?: AllTagsList | AllTagsList[];
@@ -66,7 +66,7 @@ declare module 'nekosia.js' {
          * @example safe
          * @default safe
          */
-        rating?: 'safe' | 'questionable' | 'nsfw';
+        rating?: 'safe' | 'suggestive';
     }
 
     /**
@@ -401,7 +401,7 @@ declare module 'nekosia.js' {
          * @type Object
          * @returns A Promise resolving to an `ImageResponse`.
          */
-        static fetchCategoryImages(category: AllTagsList, options?: FetchImagesCategoryOptions): Promise<ImageResponse>;
+        static fetchCategoryImages(category: AllTagsList | 'random', options?: FetchImagesCategoryOptions): Promise<ImageResponse>;
 
         /**
          * Fetches images based solely on the tags provided by the user. The main category does not affect the image selection as it is not provided here.

package/types/tags.ts

@@ -1,3 +1,4 @@
-export const TAGS = ['absolute-territory','after-the-rain','afternoon-tea','ahoge','ajitani-hifumi','akazukin','aksktrpg','akura','alice-in-wonderland','alice-margatroid','alice-tendou','alllisso','alluring-face','alona','alone','amamine','amamineko-cafe','amashiro-natsuki','ame-nochi-yuki','ameto-yuki','angel','angry-face','animal-ears','apex','apple','apple-caramel','apple-pie','apron-dress','aqua','aquarium','areola-slip','aria-tsukushi','arknights','arknights-battle-illustration-contest','armed-girls','armpits','ashen-hair','assault-rifle','autumn','autumn-leaves','axillary-costume','azki','azkiart','azur-lane','babydoll','back-alley','background','balloon','balloons','bandages','bandaid','bangtail','bare-feet','bare-soles','barefoot','basketball','basketball-uniform','bath-time','bath-towel','beach','beach-ball','bear-ears','beargirl','beast-girl','beautiful','beautiful-reimu','bed','bed-hair','bedroom','belly','belly-glimpse','bellybutton','bench','beret','bewitching-thighs','bikini','bikini-top','birthday','black-and-white','black-bikini','black-dress','black-hair','black-hair-with-red-eyes','black-knee-high-socks','black-ribbon','black-sailor-uniform','black-shoes','black-skirt','black-stockings','black-thigh-high-socks','black-thigh-highs','black-tights','blazer','blonde','bloomers','blue-archive','blue-eues','blue-eyes','blue-hair','blue-ribbon','blue-shoes','blue-skirt','blue-sky','blushing','bocchi-chan','bondage','botamochi','bottomless','boy-cut','bra','braid','breast-hold','breasts','bride','brown-hair','bubble-tea','bunny-ears','bunny-girl','butterfly','by-the-window','cable-knitting','cake','cameltoe','camisole','camisole-dress','canal','candy','candy-apple','car','cardigan','cardigan-uniform','casual-wear','cat','cat-and-girl','cat-ears','cat-ears-hat','cat-ears-headphones','cat-ears-hoodie','cat-ears-maid','cat-mouth','cat-paws','cat-pose','cat-tail','catboy','catgirl','cats','celia-claire','celica','cheeks','cheerleader','chericot-rozel','cherry','cherry-blossom','cherry-petals','chess','chest-outline','chibi','chihuahua','chin-resting','chinese-lolita','chinese-style','chino','chino-kafuu','chitosezaka-suzu','chiyu','chocolate','chocolate-mint','choker','christmas','chuuni','classroom','cloak','closed-eyes','clouds','cocoa-hoto','coffee','collar','comic-treasure','confused','cookie','corset','cosmos','costume-change','cross-halter-bikini','crossed-legs','crying','cuite','cutaway-shoulder','cute','cute-cat','cuteness-is-justice','dakimakura-cover','dango','detexted','dog-and-girl','dog-ears','dog-girl','doll','donut','doujin','drawers','drawmei','dress','dress-shirt','dvdart','elementary-school-student','elevator','enticing-brassiere','epic-seven','exposed-back','eye-mask','eyepatch','fairy-eye','fairy-tale','fallenshadow','fantasy','fantasy-girl','feather-ears','feet','felicia-lulufleur','festival-of-white','firefly','fishnets','flare-skirt','flared-bikini','flat-chest','floral-playing-cards','flower','flowers-and-girls','forest','fox','fox-ears','fox-mask','fox-shrine-maiden','foxgirl','frills','fubuki-shiragami','fubuki-shiragami-fanart','fuwamoco','fuwawa-abyssgard','fuyoyo','fuzzy','fwmcpix','game','game-pad','gamer','gamer-girl','ganbare-ganbare','garter','garterbelt','gawr-gura','genshin-impact','gensokyo-in-spring','getting-dressed','gijinka','girl','girls','girls-frontline','glasses','gloves','gothic-lolita','greek-foot','green-eyes','green-hair','green-ribbon','guildcq','guitar','gun','gym-uniform','hairdressing','hairpin','hairstyle-change','hajime-todoroki','hakui-koyori','half-pants','half-pigtails','half-up-hairstyle','halloween','halo','hamico','hammock','han-costume','hanami','hands-forming-a-heart','harness','haruhara-shun','hayate-hisakawa','hazakura-chikori','headband','headboard-angle','headdress','headphone','headphones','headset','heart','heart-eyes','heartbreak','hearts','hedgehog','heels','herta','heterochromia','hibiki','hibiscus','high-angle','high-school-girl','high-waisted-skirt','hiiro','hikaru','himura-moritaka','hizuki-miu','hizuki-rurufu','holding-hands-with-fingers-interlocked','holding-ice-in-mouth','hololive','hololive-en','hololive-english','hololiveen','holox','hong','honkaistarrail','hood','hoodie','hoshi','hoshino','hoshitsuki-neiro','hoshizora-no-memoria','hot-spring','houzuki-michiru','hu-tao','hutao','hydrangea','ice-cream','ichigo','ichigori-ena','idol','illumination','in-the-train','incredibly-cute','indie-virtual-youtuber','indie-vtuber','indoor-shoes','infamous-left-foot-defense','inflatable-pool','inner-color','inugami-korone','itigori-ena','itou-yuna','izayoi-nonomi','jagged-sclera','japanese-clothes','japanese-maid','japanese-style','japanese-style-maid','japanese-umbrella','jersey','jk','jumper-skirt','jumpy','just-woke-up','kabashima-hana','kamiko-kana','kamioka-chiroru','kamisato-ayaka','kamiyama-shiki','kanade-otonose','kancolle','kantai-collection','kanzaki-ririka','karin','karyl','katana','katcolle','kazari-rua','kazueru','kazusa-kyoyama','kigurumi','kimono','kimono-dress','kindergarten-pupil','kingdom','kirakira-monstars','kiryuu-kikyou','kitchen','klee','knee-high-socks','kneeling','knockout-knockers','kohaku-nene','koharu','koiko-irori','koito-amuno','kokoro-amamiya','korie-riko','koyori-hakui','koyori-sketch','kuda-izuna','kuro-namako','kuromi-serika','kuroneko','kyaru','kyouyama-kazusa','lancat','lanmewko','lap-pillow','laplus-darkness','large-breasts','lattice-tower','left-foot-shield','legato','leggings','legs','lemon','leo','lily-of-the-valley','lime','lingerie','little-devil','lolipop-complete','lolita','lolita-fashion','lollipop','long-black-hair','long-blond-hair','long-gloves','long-hair','long-pink-hair','long-red-hair','long-white-gloves','long-white-hair','loungewear','lying-down','lying-on-one-side','macaron','machikaze-fuuna','mad','magical-girl','maid','maid-bikini','maid-uniform','makeup','mari-iochi','marie','marine','marine-day','marine-look','maruro','mascot','matsumiya-kiseri','mayoi-shigure','mea-kagura','medium-hair','mf-bunko-j','middle-school-student','midori-matsukaze','midriff','mihoshi-mei','miike-chan','mika','mika-misono','mikeneko','miko','miku-maekawa','minami-kotone','minato-aqua','mini-hakama','miniskirt','miniskirt-miko','mint','mirror','miu-channel','miu-hizuki','mizukiart','mococo','mococo-abyssgard','mole-under-the-eye','moon','murasaki-shion','muryo','myoya','nachoneko','nagi-hisakawa','nahida','nail-polish','nanashi-mumei','nap','natori-sana','necktie','necomi','needs-to-be-appreciated-more','negligee','nekoha-shizuku','nekomata-okayu','nene-kusanagi','new-year','newsboy-cap','night','night-sky','nijisanji','nikke','nine-tailed','nintendo-switch','nintendoswitch','no-game-no-life','noire','nolan','nonaka-yuu','nurse','off-shoulder','off-shoulder-dress','okomeillust','okusora-ayane','old-fashioned-school-swimsuit','older-girl','omochi-box','omochi-monaka','one-eye-covered','one-piece','one-piece-swimsuit','ookami-mio','open-shirt','orange-hair','orange-ribbon','otokonoko','overalls','overly-long-sleeves','pajamas','panchira','panda-ears','panties','pants','parasol','park','patting','paw-pads','peace-sign','pekora-usada-fanart','personification-of-drinks','photo-editing','pigtails','pillow','pinching-garments','pink','pink-eyes','pink-hair','pink-ribbon','pink-shoes','pink-skirt','pink-sweater','pink-twintails','plaid-pattern','plaid-skirt','plastic-bottle','platform','playing-cards','plump-thighs','plushie','pocky','pointy-ears','polar-bear','ponytail','pool','pool-at-night','porch','present','princess-connect','project-sekai','prone-position','psycho','pu-ht','purple-ears','purple-eyes','purple-hair','purple-ribbon','purple-skirt','queen-of-hearts','rabbit-girl','ragna-doll','railroad-crossing','railway','rain','rainy-season','ramune','randoseru','rawr','re-oekaki','red-and-blue','red-eyes','red-hair','red-pigtails','red-ribbon','red-ribbons','red-skirt','reflected-glare','regloss','reimu-hakurei','reisa-uzawa','remilia-scarlet','rena-yorumi','reverse-sitting','rhodes','ribbed-fabric','ribbon','ribbonos','ribbons','ringo-chan','roar','rocket-launcher','roxanne','rribbon','rubbib','rucaco','rukako','ruki-roki','rumi','runa-shinomiya','rurudo','rurudo-lion','rushia-uruha','sad','saekiya-sabou','saiba-midori','saiba-momoi','sailor','sailor-dress','sailor-one-piece','sailor-swimsuit','sailor-uniform','sakamata-chloe','sakura','sakura-miko','sakuraba-moeka','sakurada-hane','sakuradahane','sakurai-hana','sand','santa','santa-cosplay','sassy-loli','scared','scarf','scenery','school-swimsuit','school-uniform','school-uniform-cardigan','school-uniform-hoodie','schoolgirl','scornful-eyes','sea','see-through','selfie','setokane','shano-hiyori','shanoa-asmr','shigure','shiori','shirai-tanuki','shirakami-fubuki','shirakawa-yumea','shirasu-azusa','shiroko','shiroko-terror','shiromichan','shooting-star','short-boots','short-haircut','short-pants','short-white-hair','shouu-kun','showgirl','shy','side-string-bikini','side-tie-panty','silver-hair','silver-long-hair','singer','sisters','sitting','sitting-on-feet','sitting-with-hands-around-knees','skirt','skirt-lift','skirtm','sleep','sleep-wear','sleeping-face','sleepy','sleepy-face','sleeveless','sleeveless-dress','sleeveless-parka','small-breasts','small-fangs','smile','snack-nili','sneakers','snow','snow-leopard','snowman','snowy-landscape','socks','sofa','sole','somna','sorasaki-hina','spiral-eyes','splashes','spring','squirrel','stairs','standing-picture','starlight-stage','starry-sky','starry-sky-dress','steamed-bun-with-meat-filling','stockings','straight-fringe','strap-shoes','straw-hat','strawberries','strawberry','streaked-hair','string-ribbon','striped-bikini','striped-thigh-high-socks','sukumizu','summer','summer-dress','summer-kimono','summer-pockets','sunaookami-shiroko','sunflowers','sunglasses','sunohara-kokona','sunset','supine','suspender-skirt','suzuho-hotaru','sweat','sweater','sweets','swim-ring','swimsuit','swimsuit-parka','swimwear','swing','sword','t-shirt','tail','tail-from-under-skirt','tail-holding','tail-with-ribbon','taiwan','takanashi','takanashi-hoshino','tattoo','tea','tea-time','tears','teary-eyed','teary-eyes','telephone','tenshinoikenie','test','the-person-behind','the-soles-of-feet-in-socks','theriantrope','thick-eyebrows','thigh-high-socks','thigh-highs','thighhighs','thighs','tie-side-bikini','tiered-dress','tiger','tights','tired','tobu-railway','toes','tokoshibyra','tongue-out','touhou','touhou-project','towel','transparency','trick-or-treat','tropical-fish','tsugiri-noa','twins','twintails','uise-iu','umbrella','underwater','uniform','upwards-gaze','uruha-rushia-fanart','usada-pekora','usagigo','valentine','vampire','vdonburi','vrchat','vtuber','w-sitting','wa-lolita','waitress','wallpaper','water','water-surface','watermelon','weapon','wearing-only-a-shirt','wedding-dress','wet','wet-see-through','white-bikini','white-cat','white-day','white-dress','white-hair','white-hairpin','white-hait','white-high-socks','white-knee-high-socks','white-ribbon','white-sailor-uniform','white-school-swimsuit','white-skirt','white-socks','white-stockings','white-swimsuit','white-thigh-high-socks','white-tiger','white-tights','white-twintails','wings','wink','winter','witch','wolf-ears','wolf-girl','yandere','yaoyao','yawn','yellow-eyes','yellow-hair','yellow-ribbon','yoko','young-boy','young-girl','yuika-shiina','yukata','yukihana-lamy','yukinoshita-peo','yutori-natsu','yuuki-sakuna'] as const;
+export const TAGS =
+    ['absolute-territory','after-the-rain','afternoon-tea','akazukin','alice-in-wonderland','alice-mana','alllisso','alluring-face','alona','alone','amamine','amamineko-cafe','amashiro-natsuki','angel','angry-face','animal-ears','apex','apple','apple-caramel','apple-pie','apron-dress','aqua','aquarium','aria-tsukushi','arknights','arknights-battle-illustration-contest','armed-girls','armpits','ashen-hair','assault-rifle','autumn','autumn-leaves','axillary-costume','azki','azkiart','azur-lane','babydoll','back-alley','background','balloon','balloons','bandages','bandaid','bare-feet','barefoot','basketball','basketball-uniform','beach','beast-girl','beautiful','beautiful-reimu','bed','bed-hair','bedroom','belly-glimpse','bellybutton','bench','beret','bewitching-thighs','birthday','black-and-white','black-dress','black-hair','black-hair-with-red-eyes','black-knee-high-socks','black-ribbon','black-sailor-uniform','black-shoes','black-skirt','black-stockings','black-thigh-high-socks','black-thigh-highs','black-tights','blazer','blonde','bloomers','blue-archive','blue-eyes','blue-hair','blue-ribbon','blue-shoes','blue-skirt','blue-sky','blushing','bocchi-chan','botamochi','bottomless','boy-cut','braid','breasts','brown-hair','bubble-tea','bunny-ears','bunny-girl','butterfly','by-the-window','cable-knitting','cafe','cake','camisole','camisole-dress','canal','candy-apple','car','cardigan','cardigan-uniform','casual-wear','cat','cat-and-girl','cat-ears','cat-ears-hat','cat-ears-headband','cat-ears-headphones','cat-ears-hoodie','cat-ears-maid','cat-mouth','cat-paws','cat-pose','cat-tail','catboy','catgirl','cats','cheeks','cherry','cherry-blossom','cherry-petals','chess','chibi','chihuahua','chin-resting','chinese-lolita','chinese-style','chino','chino-kafuu','chitosezaka-suzu','chocolate','chocolate-mint','choker','christmas','chuuni','classroom','cloak','closed-eyes','clouds','cocoa-hoto','coffee','coffee-shop','collar','comic-treasure','confused','cookie','corset','cosmos','crossed-legs','crying','cutaway-shoulder','cute','cute-cat','cuteness-is-justice','cyte','detexted','dog','dog-and-girl','dog-ears','dog-girl','doll','donut','doujin','drawers','drawmei','dress','dress-shirt','dvdart','elaina','elementary-school-student','elevator','epic-seven','eye-mask','eyepatch','fairy-eye','fairy-tale','fantasy','fantasy-girl','feather-ears','feet','felicia-lulufleur','festival-of-white','firefly','fireworks','fishnets','flare-skirt','flat-chest','floral-playing-cards','flower','flowers','flowers-and-girls','food','footwear','forest','fox','fox-ears','fox-mask','fox-shrine-maiden','foxgirl','frills','fubuki-shiragami','fubuki-shiragami-fanart','fuwamoco','fuyoyo','fuzzy','game','game-pad','gamer','gamer-girl','garter','garterbelt','gawr-gura','genshin-impact','gensokyo-in-spring','getting-dressed','ghost','gijinka','girl','girls','glasses','gloves','gothic-lolita','green-eyes','green-hair','green-ribbon','guildcq','guitar','gun','gym-uniform','hair-tie-in-mouth','hairdressing','hairpin','hairstyle-change','hajime-todoroki','hakui-koyori','half-pants','half-pigtails','half-up-hairstyle','halloween','halo','hamico','han-costume','hanami','hands-forming-a-heart','harness','hayate-hisakawa','hazakura-chikori','headband','headboard-angle','headdress','headphone','headphones','headset','heart','heart-eyes','heartbreak','hearts','hedgehog','heels','herta','heterochromia','hibiki','hibiscus','high-angle','high-school-girl','high-waisted-skirt','hiiro','hikaru','hizamaru','holding-hands-with-fingers-interlocked','holding-ice-in-mouth','hololive','hololive-en','hololive-english','hololiveen','holox','hong','honkaistarrail','hood','hoodie','hoshi','hoshino','hoshizora-no-memoria','hot-spring','hu-tao','hutao','hydrangea','ice-cream','ichigo','ichigori-ena','idol','illumination','in-the-train','incredibly-cute','indie-vtuber','indoor-shoes','inner-color','inugami-korone','itigori-ena','jagged-sclera','japanese-clothes','japanese-maid','japanese-style','japanese-style-maid','japanese-umbrella','jk','jumper-skirt','jumpy','just-woke-up','kabashima-hana','kamiko-kana','kamioka-chiroru','kamisato-ayaka','kamiyama-shiki','kanade-otonose','kancolle','kanon-mashiro','kantai-collection','karin','katana','katcolle','kazari-rua','kazueru','kazusa-kyoyama','kimono','kimono-dress','kindergarten-pupil','kingdom','kirakira-monstars','kiryuu-kikyou','kitchen','klee','knee-high-socks','knitted-vest','koharu','koiko-irori','koito-amuno','korie-riko','koyori-hakui','koyori-sketch','kuda-izuna','kuro-namako','kuroneko','kyaru','kyouyama-kazusa','lancat','lanmewko','laplus-darkness','large-breasts','lattice-tower','left-foot-shield','legato','leggings','legs','lemon','leo','lily-of-the-valley','lime','lingerie','little-devil','lolipop-complete','lolita','lolita-fashion','lollipop','long-black-hair','long-blond-hair','long-hair','long-pink-hair','long-red-hair','long-white-gloves','long-white-hair','loungewear','lying-down','lying-on-one-side','macaron','mad','magical-girl','maid','maid-uniform','makeup','mari-iochi','marie','marine-look','maruro','mascot','mayoi-shigure','medium-hair','middle-school-student','midori-matsukaze','mihoshi-mei','miike-chan','mika','mika-misono','mikeneko','miko','minato-aqua','mini-hakama','miniskirt','miniskirt-miko','mint','mirror','mizukiart','mococo','mococo-abyssgard','moon','murasaki-shion','muryo','myoya','nachoneko','nagi-hisakawa','nahida','nail-polish','nana-kagura','nanashi-mumei','nap','natori-sana','necktie','negligee','nekoha-shizuku','nekomata-okayu','new-year','newsboy-cap','night','night-sky','nijisanji','nikke','nine-tailed','nintendo-switch','nintendoswitch','noire','nolan','nonaka-yuu','nurse','off-shoulder','off-shoulder-dress','okomeillust','omochi-box','omochi-monaka','one-eye-covered','one-piece','ookami-mio','orange-hair','otokonoko','overalls','overly-long-sleeves','painting','pajamas','panda-ears','parasol','park','patting','peace-sign','pekora-usada-fanart','personification-of-drinks','photo-editing','pigtails','pillow','pinching-garments','pink','pink-eyes','pink-hair','pink-ribbon','pink-shoes','pink-skirt','pink-twintails','plaid-pattern','plaid-skirt','platform','playing-cards','plump-thighs','plushie','pocky','pointy-ears','ponytail','porch','present','princess-connect','project-sekai','prone-position','pu-ht','purple-ears','purple-eyes','purple-hair','purple-ribbon','purple-skirt','queen-of-hearts','railroad-crossing','railway','rain','rainy-season','ramune','randoseru','rawr','red-and-blue','red-eyes','red-hair','red-pigtails','red-ribbon','red-skirt','reflected-glare','regloss','reimu-hakurei','reisa-uzawa','remilia-scarlet','reverse-sitting','rhodes','ribbed-fabric','ribbon','ringo-chan','roar','rocket-launcher','rucaco','rukako','ruki-roki','rumi','runa-shinomiya','rurudo','rurudo-lion','rushia-uruha','sad','saiba-midori','saiba-momoi','sailor-dress','sailor-one-piece','sailor-uniform','sakamata-chloe','sakura','sakura-miko','sakuraba-moeka','sakurada-hane','sakuradahane','sakurai-hana','santa','sassy-loli','scared','scarf','scenery','school-sweater','school-uniform','school-uniform-cardigan','school-uniform-hoodie','schoolgirl','scornful-eyes','sea','see-through','selfie','setokane','shano-hiyori','shanoa-asmr','shiba-inu','shigure','shiori','shirakawa-yumea','shirasu-azusa','shiroko','shiroko-terror','shiromichan','shooting-star','short-boots','short-haircut','short-pants','short-white-hair','shouu-kun','showgirl','shy','silver-hair','silver-long-hair','singer','sisters','sitting','skirt','skirt-lift','skirtm','sleep','sleeping-face','sleepwear','sleepy','sleepy-face','sleeveless','sleeveless-dress','sleeveless-parka','small-fangs','smartphone','smile','smug-face','sneakers','snow','snowman','snowy-landscape','socks','sofa','sole','somna','sorasaki-hina','sousei','spiral-eyes','splashes','spring','squirrel','standing-picture','starlight-stage','starry-sky','starry-sky-dress','steamed-bun-with-meat-filling','stockings','straight-fringe','strap-shoes','straw-hat','strawberries','strawberry','streaked-hair','striped-thigh-high-socks','summer','summer-dress','summer-kimono','summer-pockets','sunaookami-shiroko','sunflowers','sunohara-kokona','sunset','supine','suspender-skirt','suzuho-hotaru','sweat','sweater','sweets','swimwear','swing','sword','tail','tail-from-under-skirt','tail-holding','tail-with-ribbon','taiwan','takanashi','takanashi-hoshino','tea','tea-time','tears','teary-eyed','teddy-bear','telephone','the-person-behind','the-soles-of-feet-in-socks','thick-eyebrows','thigh-high-socks','thigh-highs','thighhighs','thighs','tiered-dress','tiger','tights','tired','tobu-railway','toes','tongue-out','touhou','touhou-project','tropical-fish','twins','twintails','uise-iu','umbrella','underwater','uniform','upwards-gaze','usada-pekora','usagigo','valentine','vampire','vdonburi','vrchat','vtuber','w-sitting','wa-lolita','waitress','wallpaper','wallpapers','water','water-surface','watermelon','weapon','wedding-dress','wet','what-is-this-cuteness','white-cat','white-day','white-dress','white-hair','white-hait','white-high-socks','white-knee-high-socks','white-ribbon','white-sailor-uniform','white-skirt','white-socks','white-stockings','white-thigh-high-socks','white-tiger','white-tights','white-twintails','wings','wink','winter','witch','wolf','wolf-ears','wolf-girl','yandere','yaoyao','yawn','yellow-eyes','yellow-hair','yellow-ribbon','yoko','young-boy','young-girl','yuika-shiina','yuimisu','yukata','yukihana-lamy','yukinoshita-peo','yutori-natsu','yuuki-sakuna'] as const;
 
-// https://api.nekosia.cat/api/v1/tags
+// GET https://api.nekosia.cat/api/v1/tags