API
API
Dashboard
Privacy Policy & Terms of Use
Introduction
Images API
Bans API
Kumo API
Lyrics & Music API
DBL Integration
Webhooks
Powered by GitBook

Images API

Random hand-picked images, random memes from Reddit and other Reddit parsers.

get
Get random image

https://api.ksoft.si/images/random-image
Gets random image from the specified tag.
Request
Response
Request
Headers
Authentication
required
string
Authentication token
Query Parameters
nsfw
optional
boolean
Default: false, if to show nsfw content
tag
required
string
Name of the tag
Response
200: OK
Image successfully retrieved.
{
    "url": "https://api-cdn.ksoft.si/media/i-p_gksmnq-84.jpg",
    "snowflake": "i-p_gksmnq-84",
    "nsfw": false,
    "tag": "birb"
}
404: Not Found
Could not find an image matching this query.
{
    "code": 404,
    "message": "Nothing found using your query.",
    "cache": false
}

get
List of Tags

https://api.ksoft.si/images/tags
Retrieve the list of all available tags.
Request
Response
Request
Headers
Authorization
required
string
Authorization token
Response
200: OK
{
    "models": [
        {
            "name": "pepe",
            "nsfw": false
        },
        {
            "name": "doge",
            "nsfw": false
        },
        {
            "name": "kappa",
            "nsfw": false
        },
        {
            "name": "dab",
            "nsfw": false
        },
        {
            "name": "birb",
            "nsfw": false
        },
        {
            "name": "dog",
            "nsfw": false
        },
        {
            "name": "hentai_gif",
            "nsfw": true
        },
        {
            "name": "floofs",
            "nsfw": false
        },
        {
            "name": "lewd",
            "nsfw": true
        },
        {
            "name": "fbi",
            "nsfw": false
        },
        {
            "name": "neko",
            "nsfw": true
        },
        {
            "name": "Glomp",
            "nsfw": false
        },
        {
            "name": "lick",
            "nsfw": false
        },
        {
            "name": "kiss",
            "nsfw": false
        },
        {
            "name": "smack",
            "nsfw": false
        },
        {
            "name": "spank",
            "nsfw": false
        },
        {
            "name": "pat",
            "nsfw": false
        },
        {
            "name": "hug",
            "nsfw": false
        }
    ],
    "tags": [
        "pepe",
        "doge",
        "kappa",
        "dab",
        "birb",
        "dog",
        "floofs",
        "fbi",
        "Glomp",
        "lick",
        "kiss",
        "smack",
        "spank",
        "pat",
        "hug"
    ],
    "nsfw_tags": [
        "hentai_gif",
        "lewd",
        "neko"
    ]
}

get
Tag search

https://api.ksoft.si/images/tags/{search}
Search for tags.
Request
Response
Request
Path Parameters
search
required
string
Search query
Headers
Authorization
required
string
Authentication token
Response
200: OK
If you replace {search} in the URL with "birb" you get this response:
{
    "models": [
        {
            "name": "birb",
            "nsfw": false
        }
    ],
    "tags": [
        "birb"
    ]
}

get
Get image from ID (snowflake)

https://api.ksoft.si/images/image/{snowflake}
Retrieve image data.
Request
Response
Request
Path Parameters
snowflake
required
string
Image snowflake (unique ID)
Headers
Authorization
required
string
Authentication token
Response
200: OK
For example if you replace {snowflake} with i-hcz0h5bg-33 the API will return this:
{
    "url": "https://api-cdn.ksoft.si/media/i-hcz0h5bg-33.jpg",
    "snowflake": "i-hcz0h5bg-33",
    "nsfw": false,
    "tag": "birb"
}
404: Not Found
If image with that identifier does not exist.
{
    "code": 404,
    "message": "Image does not exist."
}

get
Get random meme

https://api.ksoft.si/images/random-meme
Retrieves a random meme from the cache. Source: reddit
Request
Response
Request
Headers
Authorization
required
string
Authentication token
Response
200: OK
Retrieves a random meme in a reddit object.
{
    "title": "I do it all the time",
    "image_url": "https://i.imgur.com/I7jphHT.jpg",
    "source": "https://www.reddit.com/r/memes/comments/9gsc6e/i_do_it_all_the_time/",
    "subreddit": "r/memes",
    "upvotes": 4331,
    "downvotes": 173,
    "comments": 100,
    "created_at": 1537251612,
    "nsfw": false,
    "author": "/u/Holofan4life",
    "awards": 0
}

get
Wikihow

https://api.ksoft.si/images/random-wikihow
Retrieves weird images from WikiHow
Request
Response
Request
Headers
Authorization
required
string
Authentication token
Query Parameters
nsfw
optional
boolean
Default: false, if to display nsfw content.
Response
200: OK
{
    "url": "https://api-cdn.ksoft.si/media/wikihow/i-movo1mn4.jpg",
    "title": "Pierce Your Own Belly Button At Home",
    "nsfw": false,
    "article_url": "https://www.wikihow.com/pierce-your-own-belly-button-at-home"
}

get
Random cute pictures

https://api.ksoft.si/images/random-aww
Get random cute pictures, mostly animals.
Request
Response
Request
Headers
Authorization
required
string
Authentication token
Response
200: OK
{
    "title": "no words for this love",
    "image_url": "https://i.redd.it/g4pof35510o11.jpg",
    "source": "https://www.reddit.com/r/Eyebleach/comments/9i8rwo/no_words_for_this_love/",
    "subreddit": "r/Eyebleach",
    "upvotes": 110,
    "downvotes": 1,
    "comments": 4,
    "created_at": 1537713156,
    "nsfw": false,
    "author": "/u/rosliasantamaria",
    "awards": 0
}

get
Random NSFW

https://api.ksoft.si/images/random-nsfw
Retrieves random NSFW pics. (real life stuff)
Request
Response
Request
Headers
Authorization
required
string
Authentication token
Query Parameters
gifs
optional
boolean
Default: false, if to retrieve gifs instead of images
Response
200: OK
{
    "title": "Good morning",
    "image_url": "https://i.redd.it/example.nsfw",
    "source": "https://www.reddit.com/r/pawg/comments/9gk6rx/good_morning/",
    "subreddit": "r/pawg",
    "upvotes": 4179,
    "downvotes": 83,
    "comments": 49,
    "created_at": 1537189909,
    "nsfw": true,
    "author": "/u/thementaltyrant",
    "awards": 0
}

get
Random images from a subreddit

https://api.ksoft.si/images/rand-reddit/{subreddit}
Retrieve images from the specified subreddit.
Request
Response
Request
Path Parameters
subreddit
required
string
Specified subreddit
Headers
Authorization
required
string
Authentication token
Query Parameters
remove_nsfw
optional
boolean
Default: false, if set to true, endpoint will filter out nsfw posts.
span
optional
string
Default: "day", select range from which to get the images. Can be one of the following: "hour", "day", "week", "month", "year", "all"
Response
200: OK
Normal response, if down-vote count is zero, it's probably because the post hasn't been updated by our background workers.
{
    "title": "Its Treason Then",
    "image_url": "https://i.redd.it/4t2kvw1040o11.jpg",
    "source": "https://www.reddit.com/r/PrequelMemes/comments/9i8vx0/its_treason_then/",
    "subreddit": "r/PrequelMemes",
    "upvotes": 3564,
    "downvotes": 0,
    "comments": 39,
    "created_at": 1537714103,
    "nsfw": false,
    "author": "/u/Skie69",
    "awards": 0
}
400: Bad Request
This is returned when span parameter has an unexpected value.
{
    "error": true,
    "code": 125,
    "message": "span parameter has an invalid value. can be: day (default), hour, week, month, year or all"
}
404: Not Found
This is returned when the subreddit doesn't exist.
{
    "error": 404,
    "message": "subreddit not found"
}
410: Gone
{
​
    "error": true,
    "code": 130,
    "message": "reddit returned no results, try extending your span to week or month (set 'span' GET parameter)"
}
Previous
Introduction
Next
Bans API
Last updated 7 months ago
Contents
get
Get random image
get
List of Tags
get
Tag search
get
Get image from ID (snowflake)
get
Get random meme
get
Wikihow
get
Random cute pictures
get
Random NSFW
get
Random images from a subreddit