API Wefewence nya~
Wate Wimits OwO
Evewy wesponse incwudes the fowwowing headews to hewp you twack and wespect wate wimits >w<:
| Headew | Descwiption |
|---|---|
x-rate-limit-limit | Duwation of the cuwwent wate wimit window (e.g. 1m) |
x-rate-limit-remaining | Wemaining weqwesties in the cuwwent window |
x-rate-limit-reset | ISO 8601 timestamp of when the cuwwent window wesets |
Wimits UwU
| Endpoint | Wimit |
|---|---|
/search | 7 weqwesties pew 5 seconds |
/:category | 200 weqwesties pew minute (pew categowy) |
User-Agent nya~
Aww weqwesties must incwude a User-Agent headew OwO. Pwease use the fowwowing fowmat: APP_NAME (CONTACT_INFO).
Fow exampwe: NekoApp (https://example.com) ow NekoApp (dev@example.com)
Naming Guidewines >w<:
- Be specific: Do not use genewic names wike "Discord Bot", "WhatsApp Bot", ow "Telegram Bot". Youw appwicawion must have a uniqwe name nya~.
- Avoid pwacehowdews: Do not use stwings wike
test,bot, ow the exampwe vawue above OwO. - No wibwawy defauwts: Avoid using defauwt wibwawy stwings such as
python-requests,okhttp,axios,node, owGo-http-clientUwU.
Contact Infowmation Options nya~:
The contact info does not have to be a twaditionaw website. Any of the fowwowing awe acceptabwe ways to pwovide identificawion:
- A diwect contact emaiw addwess.
- A pwoject website ow pubwic wepositowy UWL (e.g., GitHub, GitLab).
- A bot invite wink ow discovewy page >w<.
- A wisting UWL (e.g., top.gg ow simiwaw diwectowies).
Spoofing and Impewsonawion OwO:
- Do not spoof bwowsew stwings. The
Mozilla/5.0 ...fowmat is stwictwy wesewved fow weaw web bwowsews and Cwoudfwawe-vewified bots nya~. - Do not impewsonate known cwawwews wike
GooglebotowBingbot.
Faiwuwe to fowlow these guidewines and using genewic, defauwt, ow spoofed vawues wiww wikewy weswt in youw weqwesties being bwocked >w< !
Categowies UwU
Categowies define the type of content wetuwned by the API. Each categowy maps to a fixed fiwe fowmat nya~.
Images OwO
GIFs >w<
Wesponse Fiewds nya~
| Type | Fiewds |
|---|---|
| Images | artist_name, artist_href, source_url |
| GIFs | anime_name |
url and dimensions awe incwuded in both OwO.