Images

get
Get An image (JSON)

https://api.furry.bot/v2/:cat
Get an image from the specified category
Request
Response
Request
Path Parameters
cat
required
string
The category name.
Query Parameters
limit
optional
number
Number between 1-5 for the number of images to return
Response
200: OK
Image fetched successfully
{
images: [
{
artists: [
"kotenokgaff"
],
sources: [
"https://e621.net/post/show/1103171",
"https://www.furaffinity.net/view/22240977/"
],
width: 900,
height: 1080,
url: "https://i.furcdn.net/V2/furry/sfw/hug/4lPLPb6r9RHsqOaJdKcMOmPIhQR8ar.jpg",
type: "image/jpeg",
name: "4lPLPb6r9RHsqOaJdKcMOmPIhQR8ar.jpg",
shorturl: "https://r.furry.services/C6FyCX6Nco",
ext: "jpg"
}
],
$schema: "https://api.furry.bot/V2/schema.json",
success: true
}
404: Not Found
No images were found in the specified category (may be invalid or empty).
{
success: false,
error: {
message: "No images were found in that category. (category may not exist)",
type: "filesystem",
category: {
db: "furry.sfw.invalid",
dir: {
location: "/var/www/sites/furcdn.net/images/V2/furry/sfw/invalid",
exists: false,
files: null
}
}
}
}

get
Get an image (Image)

https://api.furry.bot/v2/:cat/image
Get an image from the specified category
Request
Response
Request
Path Parameters
cat
required
string
The category name.
Response
200: OK
Image fetched successfully
The body itself will be an image, all image info will be in the headers, as listed below.
Headers:
* - there can be multiple of these per response
X-FurryBotAPI-Artist*: the artist(s) of the image
X-FurryBotAPI-Image-Extension: image extension
X-FurryBotAPI-Image-Height: the height of the image
X-FurryBotAPI-Image-Width: the width of the image
X-FurryBotAPI-Image-Type: the mime type of the image
X-FurryBotAPI-URL: the cdn url of the image
X-FurryBotAPI-Source*: the source(s) of the image
X-FurryBotAPI-Short-URL: the shorturl link of the image
X-FurryBotAPI-Version: the version of the api (2)
X-FurryBotAPI-Schema: the json schema (https://api.furry.bot/V2/schema.json)
404: Not Found
No images were found in the specified category (may be invalid or empty).
{
success: false,
error: {
message: "No images were found in that category. (category may not exist)",
type: "filesystem",
category: {
db: "furry.sfw.invalid",
dir: {
location: "/var/www/sites/furcdn.net/images/V2/furry/sfw/invalid",
exists: false,
files: null
}
}
}
}