Lolis.life

This is the official API wrapper for Lolis.life, the best API for random loli images and other general things.

Introduction

This API wrapper and the official API are inspired by the popular Nekos.life, and both projects are under a MIT License. All credits to them for the ideas ;)!

P.S. This API is made by loli-lovers for loli-lovers, use it as you want and, most important, love lolis! :O

Installation

npm i lolis.life

This wrapper is granted without any external dependencies!

A bit of Documentation

Actually, lot of endpoints are work in progress.

SFW & others endpoints

NSFW endpoints

In the future, there will also be NSFW shota endpoints, "complete a sentence with random word"(W.I.P. name lol) endpoint and the current database will expand with a lot of more lolis and shota images.

The lolis endpoint, actually, contains (for now) 352 loli images; the shotas endpoint, instead, contains 92 shota images. The nsfw lolis endpoint anctually contains 95 nsfw loli images.

The structure of the returned data, for the main lolis and shotas endpoints, is like this:

{"url": "https://i.imgur.com/jO2Ecs2.jpg"}

For 'all'-type lolis and shotas endpoints, the structure is like this:

{"lolis": ["https://i.imgur.com/jO2Ecs2.jpg", ...]}

For the rhymes endpoint, the structure is like this:

{"words": ["bid", "kid", ...]}

And for the sentiments endpoint, the structure is like this:

{"score": -1, "positive-words": ["love"], "negative-words": ["hate", "stupid"]}

Also, you can retrieve the data in three ways, as it will be explained in the Examples, under this paragraph: you can use async/await(asyncio), Promises and callbacks.

Examples

Async/await Example

// creating the Loli constant, that is the module itself.
const Loli = require('lolis.life');
 
// Instantiating a new Loli class...
const loli = new Loli();
 
// Trying the Promise version with async/await(asyncio) resolving...
async function testAsync() {
    // logging in console the output...
    console.log(await loli.getSFWLoli());
};
 
testAsync();

Promises Example

// creating the Loli constant, that is the module itself.
const Loli = require('lolis.life');
 
// Instantiating a new Loli class...
const loli = new Loli();
 
// Trying the Promise version with common #then resolving...
loli.getSFWLoli().then((loliJSONoutput) => {
    // logging in console the output...
    console.log(loliJSONoutput); 
});

Callback Example

// creating the Loli constant, that is the module itself.
const Loli = require('lolis.life');
 
// Instantiating a new Loli class...
const loli = new Loli();
 
// Trying the callback version...
 
/* 
* In this function, we're passing a callback function as parameter.
* This callback function will get executed when the code is finished and gets two parameters, the first that will 
* be an eventual error(else, if there isn't an error, it will be null), and the second that will be
* the random loli image url.
 */
loli.getSFWLoli((error, loliJSONoutput) => { 
 
    // logging in console the output...
    // if there's any error
    if (error) {
        // show error
        console.error(error);
    // else, if correct JSON data
    } else {
        // show JSON data
        console.log(loliJSONoutput); 
    };	
});

If you follow carefully the Callback Example, you can also learn the callback schema, as it's just formed by two parameters, error and JSON data. If the one exists, the other is null, and viceversa.

#feelSentence Example

const Loli = require('lolis.life');
const loli = new Loli();
loli.feelSentence("I love lolis and I hate traps.").then(r => console.log()); // {"score": -1, "positive-words": ['love'], "negative-words": ['traps', 'hate']}

Showcase

A website that showcases this API can be found at https://www.danielvip3.altervista.org/.

Credits

This API, and consequently the API Wrapper, owes everything to his father API Nekos.life and it's heavily inspired by it. I can't say how many times I would thank their developers for the inspiration! Many, many thanks :)! Anyway, if someone is interested, the developer of this API and of the wrapper is Daniele De Martino, a.k.a. DanielVip3, an Italian web developer.

How to help and report bugs and issues

Yes, you can help by reporting bugs and issues in the issue tracker of this repo. Feel also free to fork it as you want(MIT license approves ;)!) and to make pull requests. Also, if you have problems, you can contact me at this email: danieledemartino.72004@gmail.com.

Complaints

If you are an artist and you don't want one of your arts/images on this website, you can contact me at danieledemartino.72004@gmail.com and send me the link of the image that you want to remove. I promise that I'll remove it in 48 hours. Many thanks for your support!