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}
getList 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"]}
getTag search
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"]}
getGet 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."}
getGet 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"}
getWikihow
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"}
getRandom 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"}
getRandom 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"}
getRandom 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)"}
Last updated Thu Oct 18 2018 09:54:51 GMT+0000 (UTC)