BYTETOOLS

Nekos.best API

Free anime image API with no key: SFW anime images and reaction GIFs by category, with artist attribution and source links. CORS enabled. Tested example.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 20 Aug 2026

What is the Nekos.best API?

Nekos.best is a free, key-free API serving safe-for-work anime images and reaction GIFs organised by category, with artist names and source links included for proper attribution.

Anime image APIs are common but most omit attribution entirely. Nekos.best includes the artist's name and a link to the original source with every image, which makes it the responsible choice if you are displaying other people's art.

Reaction categories — hug, pat, smile, wave and so on — make it well suited to Discord bots, which is its main use in practice.

Quick facts

Base URL
https://nekos.best/api/v2
Authentication
No API key required.
Rate limit
No published hard limit; fair use expected.
Pricing
Free.
CORS
Not enabled — call it from your server
Official docs
Read the docs

How to use the Nekos.best API

Every request below was executed against the live API on 20 Aug 2026, and the response shown is the real body it returned — not an illustration.

1. Fetch a random anime image

GET https://nekos.best/api/v2/neko

curl
curl 'https://nekos.best/api/v2/neko'
JavaScript (fetch)
const res = await fetch("https://nekos.best/api/v2/neko");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);
Python (requests)
import requests

res = requests.get("https://nekos.best/api/v2/neko", timeout=20)
res.raise_for_status()
print(res.json())
Response — HTTP 200
{
  "results": [
    {
      "artist_name": "Nyam",
      "artist_href": "https://twitter.com/adelie_cat",
      "source_url": "https://twitter.com/adelie_cat/status/1881649330370793775",
      "url": "https://nekos.best/api/v2/neko/01566889-ab90-4805-a6a5-041b6f68714f.png",
      "dimensions": {
        "width": 1100,
        "height": 1500
      }
    }
  ]
}

Parameters

ParameterTypeRequiredDescription
<category>pathRequiredCategory such as neko, husbando, kitsune, hug, pat, smile. neko
amountintegerOptionalNumber of results, max 20. 5

Response fields

resultsarray
The returned images or GIFs.
results[].urlstring
Direct image or GIF URL.
results[].artist_namestring
Artist name — display it.
results[].artist_hrefstring
Link to the artist's page.
results[].source_urlstring
Original source of the artwork.
results[].anime_namestring
Source anime, on GIF categories.

What you can build with the Nekos.best API

  • Build a Discord bot with reaction GIF commands
  • Add anime imagery to a community site with proper attribution
  • Create a random image feature for an anime app
  • Test image and GIF rendering with real assets

Common errors and how to fix them

404

Unknown category name.

Fix: Check the documented category list; names are lowercase single words.

Missing attribution in your UI

Artist data is provided but easy to ignore.

Fix: Display artist_name and link artist_href — that is the point of the API including them.

Large GIFs

Reaction GIFs can be several megabytes.

Fix: Lazy-load and consider a loading state.

Nekos.best API — frequently asked questions

Is Nekos.best free?

Yes, completely free with no API key required.

Is the content safe for work?

Yes, Nekos.best is SFW only, which distinguishes it from several similar anime image APIs.

Does it provide artist attribution?

Yes, and that is its main advantage — every image includes the artist name, a link to their page and the original source URL. Display them.

What categories are available?

Character categories such as neko, husbando and kitsune, plus reaction GIF categories like hug, pat, smile and wave — the latter being why it is popular for Discord bots.

Tools that pair with this API

Alternatives to Nekos.best API

If Nekos.best does not fit, these game & anime apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

APIWhat it doesAuthCORSLast verified
PokéAPIFree Pokémon API with no key: stats, types, abilities, moves, evolutions and sprites for 1,000+ species. The most popular API for learning REST. Tested example.No keyYes19 Aug 2026
Rick and Morty APIFree Rick and Morty API with no key: 800+ characters, episodes and locations with images, filtering and pagination. REST and GraphQL. Tested example.No keyYes19 Aug 2026
Jikan (MyAnimeList)Free unofficial MyAnimeList API with no key: anime and manga data, scores, characters, staff and seasonal listings. Tested curl example and live JSON.No keyYes19 Aug 2026
Deck of CardsFree playing card API with no key: shuffle decks, draw cards, manage piles and get card images. Stateful deck ids. Tested curl example and live JSON.No keyYes19 Aug 2026
NekosiaFree anime image API with no key. Every response carries a dominant colour palette, compressed and original variants, tags, artist attribution and source links. Tested example.No keyYes21 Aug 2026
Open5eFree tabletop RPG API with no key: monsters, spells, magic items and rules from the 5e SRD plus Tome of Beasts, Level Up A5e and other open sources. Live example.No keyYes21 Aug 2026
All Game & Anime APIs

Nekos.best is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 20 Aug 2026; always check the official documentation before relying on this API in production, as terms and limits can change.