nekos.life

Nekos.life

Installation

npm i -s nekos.life

Official wrapper for nekos.life! Very small install size with no external dependencies.

SFW

Function	Description
smug	Gets a URL of a smug image/gif
baka	Gets a URL of a baka image/gif
tickle	Gets a URL of a tickle image/gif
slap	Gets a URL of a slap image/gif
poke	Gets a URL of a poke image/gif
pat	Get a URL of a pat image/gif
neko	Get a URL of a neko image
nekoGif	Get a URL of a neko gif
meow	Get a URL of a cat image/gif
lizard	Get a URL of a lizard image
kiss	Get a URL of a kiss image/gif
hug	Get a URL of a hug image/gif
foxGirl	Get a URL of a fox girl image/gif
feed	Get a URL of a feeding image/gif
cuddle	Get a URL of a cuddle image/gif
kemonomimi	Get a URL of a kemonomimi image/gif
holo	Get a URL of a Holo image/gif
woof	Get a URL of a dog image/gif
wallpaper	Get a URL of a wallpaper
goose	Get a URL of a goose image
gecg	Get a URL of a gecg (genetically engineered catgirl) image
avatar	Get a URL of an avatar image
waifu	Get a URL of a waifu image
why	Get text of a question
catText	Get text of a cat emoji
OwOify	Get OwOified text of a string
8Ball	Sends the text and replies with a text as a response to the magic 8Ball and an image as well.
fact	Gets the text and replies with a text that is a random fact
spoiler	Creates an individual spoiler per letter for Discord

NSFW

Function	Description
randomHentaiGif	Get a URL of hentai gif
pussy	Get a NSFW URL of a pussy image/gif
nekoGif	Get a NSFW URL of a neko gif
neko	Get a NSFW URL of a neko image
lesbian	Get a NSFW URL of a lesbian image/gif
kuni	Get a NSFW URL of a kuni image/gif
cumsluts	Get a NSFW URL of a cumslut image/gif
classic	Gets a NSFW URL of the classic endpoint image/gif
boobs	Gets a NSFW URL of boobs image/gif
bJ	Gets a NSFW URL of bj image/gif
anal	Gets a NSFW URL of anal image/gif
avatar	Gets a NSFW URL of an avatar image/gif
yuri	Gets a NSFW URL of yuri image/gif
trap	Gets a NSFW URL of trap image/gif
tits	Gets a NSFW URL of an/a image/gif containing tits
girlSoloGif	Gets a NSFW URL of a solo girl gif
girlSolo	Gets a NSFW URL of a solo girl image
pussyWankGif	Gets a NSFW URL of a gif of pussy masterbation
pussyArt	Gets a NSFW URL of an/a image/gif of pussy art
kemonomimi	Gets a NSFW URL of an/a image/gif containing kemonomimi
kitsune	Gets a NSFW URL of an/a image/gif of kitsune
keta	Gets a NSFW URL of an/a image/gif of keta
holo	Gets a NSFW URL of an/a image/gif of Holo
holoEro	Gets a NSFW URL of an/a image/gif Holo ero
hentai	Gets a NSFW URL of an/a image/gif of hentai
futanari	Gets a NSFW URL of an/a image/gif of futa
femdom	Gets a NSFW URL of an/a image/gif of femdom
feetGif	Gets a NSFW URL of a gif of feet
eroFeet	Gets a NSFW URL of an/a image/gif of ero feet
feet	Gets a NSFW URL of an image of feet
ero	Gets a NSFW URL of an/a image/gif ero
eroKitsune	Gets a NSFW URL of an/a image/gif ero kitsune
eroKemonomimi	Gets a NSFW URL of an/a image/gif ero kemonomimi
eroNeko	Gets a NSFW URL of an/a image/gif ero neko
eroYuri	Gets a NSFW URL of an/a image/gif ero yuri
cumArts	Gets a NSFW URL of an/a image/gif of cum arts
blowJob	Gets a NSFW URL of an/a image/gif blowjob
spank	Gets a NSFW URL of an/a image/gif spank
gasm	Gets a NSFW URL of a gasm image

All of the endpoints but the ones marked with text, except Chat/8Ball/Fact in the description will return JSON: { url: <theURL>}.

sfw.catText will return JSON: {cat: <catemoji>}
sfw.why will return JSON {why: <whytext>}
sfw.OwOify will return JSON {owo: <owoified string>}

sfw.fact will return JSON {fact: <fact string>}
sfw.8Ball will return JSON {response: <8Ball response string>, url: <URL to a matching 8Ball image>}

As of now, OwOify and 8Ball are the only ones with query parameters. It requires an object containing the parameter, and the key should be the value. In this case, the key is text and the value is whatever you want OwOified. There is an example in this README. {text: 'Some text you want weebified.}

Typings

I added a typings file and will be working to improve it. This allows editors like VSC to use intellisense/autocomplete to suggest functions and help out with parameters and to see what you'll be receiving as a result of function calls.

Examples

Await/Async example

const client = require('nekos.life');
const neko = new client();

async function test() {
  console.log(await neko.sfw.hug());
}

test();

returns:

{ url: 'https://cdn.nekos.life/hug/hug10050.gif' }

Promise example

const client = require('nekos.life');
const neko = new client();

neko.sfw.catText().then((catText) => console.log(catText));

returns

{ cat: '((≡^⚲͜^≡))' }

OwOify example

const client = require('nekos.life');
const neko = new client();

async function work() {
  let owo = await neko.sfw.OwOify({text: 'This lib is really awesome!'});
  console.log(owo);
}

work();

returns

{ owo: 'This wib is weawwy awesome >w< ' }

NSFW example

const client = require('nekos.life');
const neko = new client();

neko.nsfw.neko().then(neko => {console.log(neko);});

returns

{ url: 'https://cdn.nekos.life/lewd/lewd_neko750.jpeg' }

Advanced examples

Here I'll show you how to import either sfw or nsfw if you would like to do so. That allows you to only use one or the other So if you only need sfw, you can just import that without anything nsfw!

Importing only sfw

const client = require('nekos.life');
const {sfw} = new client();

sfw.neko().then(neko => console.log(neko));

returns

{ url: 'https://cdn.nekos.life/neko/neko_083.jpg' }

Importing only nsfw

const client = require('nekos.life');
const {nsfw} = new client();

nsfw.neko().then(neko => console.log(neko));

returns

{ url: 'https://cdn.nekos.life/lewd/lewd_neko_058.jpeg' }