Skip to content

Latest commit

 

History

History
118 lines (93 loc) · 3.92 KB

README.md

File metadata and controls

118 lines (93 loc) · 3.92 KB

npm npm install size

NPM

Nekos.life

Installation

npm i -s nekos.life

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

Please note that NSFW endpoints and images have been removed from the API

This is a breaking change, please alter your code to reflect the breaking change.

Endpoints

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
eightBall 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

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

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

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

As of now, OwOify and eightBall 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.hug());
}

test();

returns:

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

Promise example

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

neko.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.OwOify({text: 'This lib is really awesome!'});
  console.log(owo);
}

work();

returns

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