Code Monkey home page Code Monkey logo

scathach-api's Introduction

npm npm install size CodeFactor chat

logo

scathach-api

easy, feature rich, object-oriented

NPM


Getting started

# npm
npm i scathach-api

# yarn
yarn add scathach-api

Advanced NSFW wrapper.
A complete rewrite and overhaul of the original lewdorder package.
Directly returned to external sites related.

Python? check scathach.py (outdated i think?), other umplementation check our base url and do GET as usual.

Please keep in mind, we have real TONS of feature here, make sure you read this docs until end.
Full maintainable changelogs available here

MEMES

Function Description
atheist Get a reddit memes URL of a atheist image
alchemist Get a reddit memes URL of a alchemist image
anime Get a reddit memes URL of a anime image
apex Get a reddit memes URL of a apex legend image
astro Get a reddit memes URL of a astronomy image
coder Get a reddit memes URL of a proggraming image
cringe Get a cringe memes URL
csgo Get a reddit memes URL of a csgo image
dota Get a reddit memes URL of a dota
fgo Get a reddit memes URL of a FGO image
gaming Get a reddit memes URL of a gaming image
gov Get a reddit memes URL of a government image
hentai Get a reddit memes URL of a hentai image
lol Get a reddit memes URL of a league of legend image
math Get a reddit memes URL of a math gif
mil Get a reddit memes URL of a military image
weebs Get a reddit memes URL of a weebs image

ANIMEMES

Function Description
blackclover Get a reddit memes URL of a blackclover image
bleach Get a reddit memes URL of a bleach image
evangelion Get a reddit memes URL of a evangelion image
fma Get a reddit memes URL of a FMA image
gintama Get a reddit memes URL of a gintama image
hxh Get a reddit memes URL of a HxH image
jojo Get a reddit memes URL of a Jojo image
kny Get a reddit memes URL of a kimetsu image
konosuba Get a reddit memes URL of a konosuba
lovelive Get a reddit memes URL of a lovelive image
nanatsu Get a reddit memes URL of a nanatsu image
naruto Get a reddit memes URL of a naruto image
opm Get a reddit memes URL of a opm image
overlord Get a reddit memes URL of a overlord image
sao Get a reddit memes URL of a SAO
shieldbro Get a reddit memes URL of a Tatenoyuusha image
snk Get a reddit memes URL of a Attackontitan image
yahallo Get a reddit memes URL of a Yuigahama image

DOTA

Function Description
elwono Gets a ytURL of a elwono videos
pub Gets a ytURL of a pog or lowiq videos
wtf Gets a ytURL of a dotaWTF videos

SFW

Function Description
anews Gets a URL of a anime-news according days
fgo Gets a URL of a Fate/Grand Order image/gif
furry Gets a URL of a furry image/gif
azur_lane Gets a URL of a azurlane image/gif
genshin_impact Gets a URL of a genshinimpact image/gif
girls_frontline Gets a URL of a girls_frontline image/gif
league_of_legends Get a URL of a lol image/gif
dota_2 Get a URL of a dota image
abigail Get a URL of a abigail (fate/grand order) image
anastasia Get a URL of a anastasia (fate/grand order) image
artoria Get a URL of a artoria (fate_all) image
bb Get a URL of a bb (fate_all) image
consort_yu Get a URL of a consort_yu (fate/grand order) image
davinci Get a URL of a davinci (fate/grand order) image
ereshkigal Get a URL of a ereshkigal (fate/grand order) image
gudako Get a URL of a gudako (fate/grand order) image
himiko Get a URL of a himiko (fate/grand order) image
jeanne Get a URL of a jeanne (fate_all) image
kama Get a URL of a kama (fate/grand order) image
kiara Get a URL of a kiara (fate/grand order) image
mashu Get a URL of a mashu (fate/grand order) image
mordred Get a URL of a mordred (fate_all) image
nero Get a URL of a nero (fate_all) image
okita Get a URL of a okita (fate_all) image
raikou Get a URL of a raikou (fate/grand order) image
saint_martha Get a URL of a saint_martha (fate/grand order) image
ushiwakamaru Get a URL of a ushiwakamaru (fate/grand order) image
xuanzang Get a URL of a xuanzang (fate/grand order) image
scathach Get a URL of a scathach (fate/grand order) image
atago Get a URL of a atago (azur_lane) image
belfast Get a URL of a belfast (azur_lane) image
bremerton Get a URL of a bremerton (azur_lane) image
dido Get a URL of a dido (azur_lane) image
enterprise Get a URL of a enterprise (azur_lane) image
formidable Get a URL of a formidable (azur_lane) image
hood Get a URL of a hood (azur_lane) image
sirius Get a URL of a sirius (azur_lane) image
st_louis Get a URL of a st_louis (azur_lane) image
taihou Get a URL of a taihou (azur_lane) image
takao Get a URL of a takao (azur_lane) image
amber Get a URL of a amber (genshin_impact) image
barbara Get a URL of a barbara (genshin_impact) image
beidou Get a URL of a beidou (genshin_impact) image
jean Get a URL of a jean (genshin_impact) image
keqing Get a URL of a keqing (genshin_impact) image
klee Get a URL of a klee (genshin_impact) image
lisa Get a URL of a lisa (genshin_impact) image
lumine Get a URL of a lumine (genshin_impact) image
mona Get a URL of a mona (genshin_impact) image

NSFW

Function Description
ahegao Gets a nsfwURL of a ahegao face
jav Gets a nsfwURL of a jav image
gif Gets a nsfwURL of a gif
twitter Gets a nsfwURL of a twitter
fgo Gets a nsfwURL of a Fate/Grand Order image/gif
furry Gets a nsfwURL of a furry image/gif
azur_lane Gets a nsfwURL of a aznsfwURLane image/gif
genshin_impact Gets a nsfwURL of a genshinimpact image/gif
girls_frontline Gets a nsfwURL of a girls_frontline image/gif
league_of_legends Get a nsfwURL of a lol image/gif
dota_2 Get a nsfwURL of a dota image
abigail Get a nsfwURL of a abigail (fate/grand order) image
anastasia Get a nsfwURL of a anastasia (fate/grand order) image
artoria Get a nsfwURL of a artoria (fate_all) image
bb Get a nsfwURL of a bb (fate_all) image
consort_yu Get a nsfwURL of a consort_yu (fate/grand order) image
davinci Get a nsfwURL of a davinci (fate/grand order) image
ereshkigal Get a nsfwURL of a ereshkigal (fate/grand order) image
gudako Get a nsfwURL of a gudako (fate/grand order) image
himiko Get a nsfwURL of a himiko (fate/grand order) image
jeanne Get a nsfwURL of a jeanne (fate_all) image
kama Get a nsfwURL of a kama (fate/grand order) image
kiara Get a nsfwURL of a kiara (fate/grand order) image
mashu Get a nsfwURL of a mashu (fate/grand order) image
mordred Get a nsfwURL of a mordred (fate_all) image
nero Get a nsfwURL of a nero (fate_all) image
okita Get a nsfwURL of a okita (fate_all) image
raikou Get a nsfwURL of a raikou (fate/grand order) image
saint_martha Get a nsfwURL of a saint_martha (fate/grand order) image
ushiwakamaru Get a nsfwURL of a ushiwakamaru (fate/grand order) image
xuanzang Get a nsfwURL of a xuanzang (fate/grand order) image
scathach Get a nsfwURL of a scathach (fate/grand order) image
atago Get a nsfwURL of a atago (azur_lane) image
belfast Get a nsfwURL of a belfast (azur_lane) image
bremerton Get a nsfwURL of a bremerton (azur_lane) image
dido Get a nsfwURL of a dido (azur_lane) image
enterprise Get a nsfwURL of a enterprise (azur_lane) image
formidable Get a nsfwURL of a formidable (azur_lane) image
hood Get a nsfwURL of a hood (azur_lane) image
sirius Get a nsfwURL of a sirius (azur_lane) image
st_louis Get a nsfwURL of a st_louis (azur_lane) image
taihou Get a nsfwURL of a taihou (azur_lane) image
takao Get a nsfwURL of a takao (azur_lane) image
amber Get a nsfwURL of a amber (genshin_impact) image
barbara Get a nsfwURL of a barbara (genshin_impact) image
beidou Get a nsfwURL of a beidou (genshin_impact) image
jean Get a nsfwURL of a jean (genshin_impact) image
keqing Get a nsfwURL of a keqing (genshin_impact) image
klee Get a nsfwURL of a klee (genshin_impact) image
lisa Get a nsfwURL of a lisa (genshin_impact) image
lumine Get a nsfwURL of a lumine (genshin_impact) image
mona Get a nsfwURL of a mona (genshin_impact) image
armpits Get a nsfwURL of a armpits image/gif
ass Get a nsfwURL of a ass image/gif
bikini Get a nsfwURL of a bikini image/gif
blowjob Get a nsfwURL of a blowjob image/gif
blush Get a nsfwURL of a blush image/gif
clothed_sex Get a nsfwURL of a clothed_sex image/gif
cowgirl_position Get a nsfwURL of a cowgirl_position image/gif
cum Get a nsfwURL of a cum
dark_skin Get a nsfwURL of a dark_skin image
doggystyle Get a nsfwURL of a doggystyle image/gif
double_penetration Get a nsfwURL of a double_penetration
foot_licking Get a nsfwURL of a foot_licking image/gif
footjob Get a nsfwURL of a footjob image/gif
furry Get a nsfwURL of a furry image/gif
futanari Get a nsfwURL of a futanari image/gif
gangbang Get a nsfwURL of a gangbang image/gif
housewife Get a nsfwURL of a housewife
impregnation Get a nsfwURL of a impregnation image
large_breasts Get a nsfwURL of a large_breasts image/gif
masturbation Get a nsfwURL of a masturbation
milf Get a nsfwURL of a milf image/gif
netorare Get a nsfwURL of a netorare image/gif
pantyhose Get a nsfwURL of a pantyhose image/gif
pervert Get a nsfwURL of a pervert
pout Get a nsfwURL of a pout image
pregnant Get a nsfwURL of a pregnant image/gif
pubic_hair Get a nsfwURL of a pubic_hair
pussy_juice Get a nsfwURL of a pussy_juice image/gif
rape Get a nsfwURL of a rape image/gif
school_uniform Get a nsfwURL of a school_uniform image/gif
smell Get a nsfwURL of a smell image/gif
sweat Get a nsfwURL of a sweat image/gif
thick Get a nsfwURL of a thick
twintails Get a nsfwURL of a twintails image
ugly_man Get a nsfwURL of a ugly_man image/gif
uncensored Get a nsfwURL of a uncensored
yaoi Get a nsfwURL of a yaoi image/gif
yuri Get a nsfwURL of a yuri

SEX

Function Description
anal Gets a nsfwURL of a anal image/gif
anal_penetration Gets a nsfwURL of a anal_penetration image/gif
areolae Gets a nsfwURL of a areolae image/gif
asian Gets a nsfwURL of a asian image/gif
ass Gets a nsfwURL of a ass image/gif
balls Gets a nsfwURL of a balls image/gif
bbc Get a nsfwURL of a bbc image/gif
bdsm Get a nsfwURL of a bdsm image
big_ass Get a nsfwURL of a big_ass gif
bondage Get a nsfwURL of a bondage image/gif
bra Get a nsfwURL of a bra image
brazzers Get a nsfwURL of a brazzers image/gif
brunette Get a nsfwURL of a brunette image/gif
cleavage Get a nsfwURL of a cleavage image/gif
cum_on_face Get a nsfwURL of a cum_on_face image/gif
cumshot Get a nsfwURL of a cumshot image/gif
deepthroat Get a nsfwURL of a deepthroat image/gif
doggystyle Get a nsfwURL of a doggystyle image/gif
finger_in_mouth Get a nsfwURL of a finger_in_mouth image/gif
from_behind Get a nsfwURL of a from_behind
handjob Get a nsfwURL of a handjob image
huge_breasts Gets a nsfwURL of a huge_breasts image/gif
large_penis Gets a nsfwURL of a large_penis image/gif
milf Gets a nsfwURL of a milf image/gif
nipples Gets a nsfwURL of a nipples image/gif
nude Gets a nsfwURL of a nude image/gif
oil Get a nsfwURL of a oil image/gif
open_mouth Get a nsfwURL of a open_mouth image
oral Get a nsfwURL of a oral
panties Get a nsfwURL of a panties image/gif
penetration Get a nsfwURL of a penetration image
penis Get a nsfwURL of a penis image/gif
porn_star Get a nsfwURL of a porn_star image/gif
removing_panties Get a nsfwURL of a removing_panties image/gif
sexy Get a nsfwURL of a sexy image/gif
sideboob Get a nsfwURL of a sideboob image/gif
slut Get a nsfwURL of a slut image/gif
stockings Get a nsfwURL of a stockings image/gif
sucking_balls Get a nsfwURL of a sucking_balls image/gif

PORN

Function Params
amateur /porn/?tags=amateur
anal /porn/?tags=anal
anal_gape /porn/?tags=anal-gape
asian /porn/?tags=asian
ass /porn/?tags=ass
ass-fucking /porn/?tags=ass-fucking
japanese /porn/?tags=ass-licking
babe /porn/?tags=babe
ball_licking /porn/?tags=ball-licking
bath /porn/?tags=bath
bbw /porn/?tags=bbw
beach /porn/?tags=beach
big_cock /porn/?tags=big-cock
big_tits /porn/?tags=big-tits
bikini /porn/?tags=bikini
blindfold /porn/?tags=blindfold
blonde /porn/?tags=blonde
blowbang /porn/?tags=blowbang
blowjob /porn/?tags=blowjob
bondage /porn/?tags=bondage
boots /porn/?tags=boots
brazilian /porn/?tags=brazilian
brunette /porn/?tags=brunette
bukkake /porn/?tags=bukkake
cameltoe /porn/?tags=cameltoe
centerfold /porn/?tags=centerfold
cfnm /porn/?tags=cfnm
cheerleader /porn/?tags=cheerleader
christmas /porn/?tags=christmas
chubby /porn/?tags=chubby
close_up /porn/?tags=close-up
clothed /porn/?tags=clothed
college /porn/?tags=college
cosplay /porn/?tags=cosplay
cougar /porn/?tags=cougar
cowgirl /porn/?tags=cowgirl
creampie /porn/?tags=creampie
cum_in_mouth /porn/?tags=cum-in-mouth
cum_in_pussy /porn/?tags=cum-in-pussy
cumshot /porn/?tags=cumshot
cum_swapping /porn/?tags=cum-swapping
deepthroat /porn/?tags=deepthroat
dildo /porn/?tags=dildo
double_penetration /porn/?tags=double-penetration
ebony /porn/?tags=ebony
european /porn/?tags=european
face /porn/?tags=face
facesitting /porn/?tags=facesitting
facial /porn/?tags=facial
fake_tits /porn/?tags=fake-tits
femdom /porn/?tags=femdom
fetish /porn/?tags=fetish
fingering /porn/?tags=fingering
fisting /porn/?tags=fisting
flexible /porn/?tags=flexible
foot-fetish /porn/?tags=foot-fetish
footjob /porn/?tags=footjob
gangbang /porn/?tags=gangbang
girlfriend /porn/?tags=girlfriend
glamour /porn/?tags=glamour
glasses /porn/?tags=glasses
granny /porn/?tags=granny
groupsex /porn/?tags=groupsex
gyno /porn/?tags=gyno
hairy /porn/?tags=hairy
handjob /porn/?tags=handjob
hardcore /porn/?tags=hardcore
high_heels /porn/?tags=high-heels
homemade /porn/?tags=homemade
housewife /porn/?tags=housewife
humping /porn/?tags=humping
indian /porn/?tags=indian
interracial /porn/?tags=interracial
jeans /porn/?tags=jeans
kissing /porn/?tags=kissing
latex /porn/?tags=latex
latina /porn/?tags=latina
legs /porn/?tags=legs
lesbian /porn/?tags=lesbian
lingerie /porn/?tags=lingerie
maid /porn/?tags=maid
massage /porn/?tags=massage
masturbation /porn/?tags=masturbation
mature /porn/?tags=mature
milf /porn/?tags=milf
missionary /porn/?tags=missionary
mom /porn/?tags=mom
natural_tits /porn/?tags=natural_tits
nipples /porn/?tags=nipples
non_nude /porn/?tags=non_nude
nurse /porn/?tags=nurse
office /porn/?tags=office
oiled /porn/?tags=oiled
orgy /porn/?tags=orgy
outdoor /porn/?tags=outdoor
panties /porn/?tags=panties
pantyhose /porn/?tags=pantyhose
party /porn/?tags=party
pegging /porn/?tags=pegging
petite /porn/?tags=piercing
piercing /porn/?tags=piercing
pissing /porn/?tags=pissing
police /porn/?tags=police
pool /porn/?tags=pool
pornstar /porn/?tags=pornstar
pov /porn/?tags=pov
pregnant /porn/?tags=pregnant
public /porn/?tags=public
pussy /porn/?tags=pussy
pussy_licking /porn/?tags=pussy_licking
reality /porn/?tags=reality
redhead /porn/?tags=redhead
saggy-tits /porn/?tags=saggy-tits
schoolgirl /porn/?tags=schoolgirl
secretary /porn/?tags=secretary
seduction /porn/?tags=seduction
self_shot /porn/?tags=self_shot
shaved /porn/?tags=shaved
short_hair /porn/?tags=short-hair
short /porn/?tags=short
shower /porn/?tags=shower
skinny /porn/?tags=skinny
skirt /porn/?tags=skirt
smoking /porn/?tags=smoking
socks /porn/?tags=socks
spanking /porn/?tags=spanking
sports /porn/?tags=sports
spreading /porn/?tags=spreading
squirting /porn/?tags=squirting
ssbbw /porn/?tags=ssbbw
stockings /porn/?tags=stockings
strapon /porn/?tags=strapon
stripper /porn/?tags=stripper
tall /porn/?tags=tall
tattoo /porn/?tags=tattoo
teacher /porn/?tags=teacher
teen /porn/?tags=teen
thai /porn/?tags=thai
threesome /porn/?tags=threesome
tiny_tits /porn/?tags=tiny-tits
titjob /porn/?tags=titjob
tribbing /porn/?tags=tribbing
undressing /porn/?tags=undressing
uniform /porn/?tags=uniform
upskirt /porn/?tags=upskirt
voyeur /porn/?tags=voyeur
wedding /porn/?tags=wedding
wet /porn/?tags=wet
wife /porn/?tags=wife
yoga_pants /porn/?tags=yoga-pants

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('scathach-api');
const scathach = new client();

async function test() {
  console.log(await scathach.sfw.ereshkigal());
}

test();

returns:

{
  url: 'https://safebooru.org/images/3141/10ad355807d1d4a21bb951ef3ce34a9d76a5e55d.jpg'
}

Promise example

const client = require('scathach-api');
const scathach = new client();
 
scathach.sfw.ereshkigal().then(scathach => {console.log(scathach);});

returns

{
  url: 'https://safebooru.org/images/3169/7d9fce8472a47977662b1373b806a4cb35d23ede.jpg'
}

NSFW example

const client = require('scathach-api');
const scathach = new client();
 
scathach.nsfw.ereshkigal().then(scathach => {console.log(scathach);});

returns

{
  url: 'https://us.rule34.xxx/images/3549/b1a68d979aa0a59ef617deffc43aa265288a9a99.jpg'
}

NSFW example #2

const client = require('scathach-api');
const scathach = new client();
 
scathach.nsfw.futanari().then(scathach => {console.log(scathach);});

returns

{
  url: 'https://img2.gelbooru.com/images/61/3f/613ff3153cf27b2f3b7b3bb10a5d30d8.jpg'
}

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('scathach-api');
const {sfw} = new client();

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

returns

{
  url: 'https://safebooru.org/images/3169/b072b4f798b5740be58afdcb275678446540ee3b.jpg'
}

Importing only nsfw

const client = require('scathach-api');
const {nsfw} = new client();

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

returns

{
  url: 'https://us.rule34.xxx/images/3824/716499a04a9f4add87c4c9887f146e18.jpeg'
}

sex Object usage

const client = require('scathach-api');
const scathach = new client();
 
scathach.sex.oral().then(scathach => {console.log(scathach);});

returns

{
  url: 'https://realbooru.com/images/690/18c1059396064e0da700680204d4cf90.webm'
}

porn Object usage

const client = require('scathach-api');
const scathach = new client();
 
scathach.porn.creampie().then(scathach => {console.log(scathach);});

returns

{
  url: 'https://cdni.pornpics.com/1280/7/104/90613135/90613135_042_53ee.jpg'
}

Legal

This tool can be freely copied, modified, altered, distributed without any attribution whatsoever. However, if you feel like this tool deserves an attribution, mention it. It won't hurt anybody :)

Please, read the license terms. Don't worry, it can be read in less than 30 seconds, unless you have some sort of reading disability - in that case, I'm wondering why you're still reading this text. Really. Stop. Please. I mean, seriously. Why are you still reading?

Acknowledgements

Since this tool includes some contributions, and I'm not an asshole, I'll publically thank the following users for their help:

scathach-api's People

Contributors

sinkaroid avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.