Skip to content

API Wefewence nya~

Wate Wimits OwO

Evewy wesponse incwudes the fowwowing headews to hewp you twack and wespect wate wimits >w<:

HeadewDescwiption
x-rate-limit-limitDuwation of the cuwwent wate wimit window (e.g. 1m)
x-rate-limit-remainingWemaining weqwesties in the cuwwent window
x-rate-limit-resetISO 8601 timestamp of when the cuwwent window wesets

Wimits UwU

EndpointWimit
/search7 weqwesties pew 5 seconds
/:category200 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, ow Go-http-client UwU.

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 Googlebot ow Bingbot.

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

husbandokitsunenekowaifu

GIFs >w<

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Wesponse Fiewds nya~

TypeFiewds
Imagesartist_name, artist_href, source_url
GIFsanime_name

url and dimensions awe incwuded in both OwO.