scathach-api
    TypeScript icon, indicating that this package has built-in type declarations

    0.0.8 • Public • Published

    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:

    Keywords

    Install

    npm i scathach-api

    DownloadsWeekly Downloads

    11

    Version

    0.0.8

    License

    MIT

    Unpacked Size

    224 kB

    Total Files

    12

    Last publish

    Collaborators

    • sinkaroid