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 (per category) |
User-Agent
All requests must include a User-Agent header. Please use the following format: APP_NAME/VERSION (WEBSITE_URL).
For example: NekoApp/1.0 (https://example.com)
Do not spoof browser strings like Mozilla/5.0 ... unless the request is actually coming from a browser.
Avoid using library defaults such as python-requests, okhttp, axios, node, or curl, impersonating known crawlers like Googlebot or Bingbot, placeholder strings like test or bot, or the example value above. Any of these are likely to get your requests blocked.
The URL doesn't need to be a website. A bot invite link, discovery page, or top.gg (or similar) listing works too.
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.