API Reference
User-Agent
All requests must include a User-Agent header. We'd appreciate it if you included your app name, version, and website link in the following format: APP_NAME/VERSION (WEBSITE_URL). For example: NekoApp/1.0 (https://example.com)
Please do not use generic strings or spoof browser User-Agent values such as Mozilla/5.0 ..., unless the request is actually coming from a browser. These are likely to get your requests blocked.
Rate Limits
Every response includes the following headers to help you track and respect rate limits:
| Header | Description |
|---|---|
x-rate-limit-limit | Duration of the current rate limit window (e.g. 1m) |
x-rate-limit-remaining | Remaining requests in the current window |
x-rate-limit-reset | ISO 8601 timestamp of when the current window resets |
Limits
| Endpoint | Limit |
|---|---|
/search | 7 requests per 5 seconds |
/:category | 200 requests per minute |
Categories
Categories define the type of content returned by the API. Each category maps to a fixed file format.
Images
husbandokitsunenekowaifu
GIFs
angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet
Response Fields
| Type | Fields |
|---|---|
| Images | artist_name, artist_href, source_url |
| GIFs | anime_name |
url and dimensions are included in both.