API-Referenz

Ratenlimits (Rate Limits)

Jede Antwort enthält die folgenden Header, die Ihnen helfen, Ratenlimits zu verfolgen und einzuhalten:

Header	Beschreibung
x-rate-limit-limit	Dauer des aktuellen Ratenlimit-Fensters (z. B. 1m)
x-rate-limit-remaining	Verbleibende Anfragen im aktuellen Fenster
x-rate-limit-reset	ISO 8601-Zeitstempel, wann das aktuelle Fenster zurückgesetzt wird

Limits

Endpunkt	Limit
/search	7 Anfragen pro 5 Sekunden
/:category	200 Anfragen pro Minute (pro Kategorie)

User-Agent

Alle Anfragen müssen einen User-Agent-Header enthalten. Bitte verwenden Sie das folgende Format: APP_NAME (CONTACT_INFO).
Zum Beispiel: NekoApp (https://example.com) oder NekoApp (dev@example.com)

Richtlinien für die Benennung:

• Seien Sie spezifisch: Verwenden Sie keine generischen Namen wie „Discord Bot“, „WhatsApp Bot“ oder „Telegram Bot“. Ihre Anwendung muss einen eindeutigen Namen haben.
• Vermeiden Sie Platzhalter: Verwenden Sie keine Zeichenfolgen wie test, bot oder den obigen Beispielwert.
• Keine Standardwerte von Bibliotheken: Vermeiden Sie die Verwendung von Standard-Bibliotheks-Strings wie python-requests, okhttp, axios, node oder Go-http-client.

Optionen für Kontaktinformationen:
Die Kontaktinformation muss keine traditionelle Website sein. Jede der folgenden Möglichkeiten ist eine akzeptable Form der Identifizierung:

• Eine direkte Kontakt-E-Mail-Adresse.
• Eine Projekt-Website oder eine öffentliche Repository-URL (z. B. GitHub, GitLab).
• Ein Bot-Einladungslink oder eine Discovery-Seite.
• Eine Listing-URL (z. B. top.gg oder ähnliche Verzeichnisse).

Vortäuschen und Identitätsdiebstahl (Spoofing & Impersonation):

• Täuschen Sie keine Browser-Strings vor. Das Format Mozilla/5.0 ... ist strikt echten Webbrowsern und von Cloudflare verifizierten Bots vorbehalten.
• Geben Sie sich nicht als bekannte Crawler aus, wie z. B. Googlebot oder Bingbot.

Die Nichtbeachtung dieser Richtlinien sowie die Verwendung generischer, Standard- oder vorgetäuschter Werte führen sehr wahrscheinlich dazu, dass Ihre Anfragen blockiert werden.

Kategorien

Kategorien definieren die Art der von der API zurückgegebenen Inhalte. Jede Kategorie ist einem festen Dateiformat zugeordnet.

Bilder

husbandokitsunenekowaifu

GIFs

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Antwortfelder

Typ	Felder
Bilder	artist_name, artist_href, source_url
GIFs	anime_name

url und dimensions sind in beiden enthalten.