NekoAPI
🌐 English · Deutsch
NekoAPI fetches random anime images from nekosapi.com and lets you filter by rating: safe, suggestive, borderline or explicit. The explicit rating is gated and only works in NSFW channels. It works as both a prefix and a slash command, with autocomplete on the rating. Author: pd-codes · requires Red 3.5.0+ · Status: Release.
[p]repo add PDC_Redbot_Cogs https://github.com/pd-codes/PDC_Redbot_Cogs
[p]cog install PDC_Redbot_Cogs NekoAPI
[p]load NekoAPI
[p]slash sync
[p] is your bot's prefix. See Installation for the full Downloader walkthrough. Run [p]slash sync once so the /nekoapi and /nekoapi-rating slash commands appear.
| Command | Type | Parameters | What it does |
|---|---|---|---|
nekoapi |
Prefix |
rating? (default safe) |
Posts a random image at the given rating. Invalid ratings list the allowed values; explicit is rejected outside NSFW channels. |
nekoapi |
Slash | – | Posts a random image fixed to the safe rating. |
nekoapi-rating |
Slash | rating |
Posts a random image at the chosen rating. The rating field has autocomplete. explicit is rejected outside NSFW channels. |
Each result is an embed with the image set, titled NekoAPI – <rating> and footed with the image ID and rating.
| Rating | Allowed where |
|---|---|
safe |
Anywhere |
suggestive |
Anywhere |
borderline |
Anywhere |
explicit |
NSFW channels only |
Only these four values are accepted (VALID_RATINGS); anything else returns an error message. The explicit gate checks the channel's NSFW flag (is_nsfw()) for both the prefix and slash command and refuses otherwise. Input is lowercased before validation.
Mark a channel as NSFW in Discord's channel settings to allow
explicit. The three other ratings carry no channel restriction in this cog — moderate access via Discord permissions if needed.
- Images are fetched live from
https://api.nekosapi.com/v4/images/random?limit=1&rating=<rating>; if the API is unreachable you get "error fetching the API". - This cog stores no data and has no configuration. It registers with the PDC Web Dashboard on load (no extra surfaces).
- For category-based images and reaction GIFs without rating filtering, see Neko.
See also: Neko · Installation · Home