Neko API

The Neko API provides access to a variety of cute and playful neko (cat) images and gifs. You can fetch images and gifs for different categories such as neko, waifu, husbando, kitsune, and more.

Base URL

"https://openapi-idk8.onrender.com"

Endpoints

GET `/neko/categories`

GET `/neko/:category`

Available Categories

Name	Format
neko	png
waifu	png
husbando	png
kitsune	png
lurk	gif
shoot	gif
sleep	gif
shrug	gif
stare	gif
wave	gif
poke	gif
smile	gif
peck	gif
wink	gif
blush	gif
smug	gif
tickle	gif
yeet	gif
think	gif
highfive	gif
feed	gif
bite	gif
bored	gif
nom	gif
yawn	gif
facepalm	gif
cuddle	gif
kick	gif
happy	gif
hug	gif
baka	gif
pat	gif
nod	gif
nope	gif
kiss	gif
dance	gif
punch	gif
handshake	gif
slap	gif
cry	gif
pout	gif
handhold	gif
thumbsup	gif
laugh	gif

Sample Request | List of Available Categories

GET "https://openapi-idk8.onrender.com/neko/categories"

Sample Response

{
  "neko": { "format": "png" },
  "waifu": { "format": "png" },
  "husbando": { "format": "png" },
  "kitsune": { "format": "png" },
  "lurk": { "format": "gif" },
  ... (other categories)
}

Sample Request | By Category

GET "https://openapi-idk8.onrender.com/neko/slap"

Sample Response (1 result (default))

{
  "results": [
    {
      "anime_name": "Seishun Buta Yarou wa Bunny Girl Senpai no Yume wo Minai",
      "url": "https://nekos.best/api/v2/slap/c2aabf26-b029-49db-b4a0-405a66fc2540.gif"
    }
  ]
}

Sample Request | With Amount (Optional)

GET "https://openapi-idk8.onrender.com/neko/slap?amount=5"

Sample Response

{
  "results": [
    {
      "anime_name": "Horimiya",
      "url": "https://nekos.best/api/v2/slap/60fecb21-8f5e-4c89-9b28-7468e38f2156.gif"
    },
    {
      "anime_name": "Chainsaw Man",
      "url": "https://nekos.best/api/v2/slap/9492af04-d58b-4680-978c-a6d3193c01b3.gif"
    },
    {
      "anime_name": "Tsuritama",
      "url": "https://nekos.best/api/v2/slap/2d7646af-81c6-4598-b58d-ddffdda3bd0d.gif"
    },
    {
      "anime_name": "Hitsugi no Chaika",
      "url": "https://nekos.best/api/v2/slap/2df935e0-32bb-478f-944f-dee423532816.gif"
    },
    {
      "anime_name": "Gakuen Mokushiroku: High School of the Dead",
      "url": "https://nekos.best/api/v2/slap/f96b6de4-408f-4c38-acaf-016ad12343ce.gif"
    }
  ]
}

Error Handling

If there is an error fetching categories or category data, the API will respond with a 500 status code and an error message.

{
  "error": "Failed to fetch categories"
}