API Reference
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 |
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 the example value above, placeholder strings like test or bot, invalid or nonexistent URLs, generic library defaults, browser strings like Mozilla/5.0 ..., or impersonate known crawlers such as Googlebot or Bingbot. These are likely to get your requests blocked.
If you don't have a website, a link to your bot's invite or discovery page works just as well.
Categories
Categories define the type of content returned by the API. Each category maps to a fixed file format.
Images
GIFs
Response Fields
| Type | Fields |
|---|---|
| Images | artist_name, artist_href, source_url |
| GIFs | anime_name |
url and dimensions are included in both.