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.
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 'https://nekos.best/api/v2/neko'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);import requests
res = requests.get("https://nekos.best/api/v2/neko", timeout=20)
res.raise_for_status()
print(res.json()){
"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
| Parameter | Type | Required | Description |
|---|---|---|---|
<category> | path | Required | Category such as neko, husbando, kitsune, hug, pat, smile. neko |
amount | integer | Optional | Number 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
JSON Formatter
Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.
Image Cropper
Crop images online to an exact rectangle with pixel-precise x, y, width and height inputs or aspect-ratio presets. Free, private and browser-based.
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.
| API | What it does | Auth | CORS | Last verified |
|---|---|---|---|---|
| PokéAPI | Free 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 key | Yes | 19 Aug 2026 |
| Rick and Morty API | Free Rick and Morty API with no key: 800+ characters, episodes and locations with images, filtering and pagination. REST and GraphQL. Tested example. | No key | Yes | 19 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 key | Yes | 19 Aug 2026 |
| Deck of Cards | Free 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 key | Yes | 19 Aug 2026 |
| Nekosia | Free 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 key | Yes | 21 Aug 2026 |
| Open5e | Free 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 key | Yes | 21 Aug 2026 |
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.