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
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
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
Headers
Authorization
required
string
Authorization token
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"
]
}
https://api.ksoft.si/images/tags/{search}
Search for tags.
Request
Response
Path Parameters
search
required
string
Search query
Headers
Authorization
required
string
Authentication token
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
Path Parameters
snowflake
required
string
Image snowflake (unique ID)
Headers
Authorization
required
string
Authentication token
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
Headers
Authorization
required
string
Authentication token
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"
}

get
Wikihow

https://api.ksoft.si/images/random-wikihow
Retrieves weird images from WikiHow
Request
Response
Headers
Authorization
required
string
Authentication token
Query Parameters
nsfw
optional
boolean
Default: false, if to display nsfw content.
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
Headers
Authorization
required
string
Authentication token
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"
}

get
Random NSFW

https://api.ksoft.si/images/random-nsfw
Retrieves random NSFW pics. (real life stuff)
Request
Response
Headers
Authorization
required
string
Authentication token
Query Parameters
gifs
optional
boolean
Default: false, if to retrieve gifs instead of images
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"
}

get
Random images from a subreddit

https://api.ksoft.si/images/rand-reddit/{subreddit}
Retrieve images from the specified subreddit.
Request
Response
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"
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"
}
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)"
}