Referencja API

Limity zapytań (Rate Limits)

Każda odpowiedź zawiera następujące nagłówki pomagające śledzić i przestrzegać limitów zapytań:

Nagłówek	Opis
x-rate-limit-limit	Czas trwania okna limitu zapytań (np. 1m)
x-rate-limit-remaining	Pozostała liczba zapytań w bieżącym oknie
x-rate-limit-reset	Znacznik czasu ISO 8601 określający reset okna

Limity

Punkt końcowy	Limit
/search	7 zapytań na 5 sekund
/:category	200 zapytań na minutę (na kategorię)

User-Agent

Wszystkie zapytania muszą zawierać nagłówek User-Agent. Prosimy o stosowanie następującego formatu: NAZWA_APLIKACJI (DANE_KONTAKTOWE).
Na przykład: NekoApp (https://example.com) lub NekoApp (dev@example.com)

Wskazówki dotyczące nazewnictwa:

• Bądź precyzyjny: Nie używaj ogólnych nazw, takich jak „Discord Bot”, „WhatsApp Bot” czy „Telegram Bot”. Twoja aplikacja musi posiadać unikalną nazwę.
• Unikaj nazw zastępczych: Nie używaj ciągów znaków takich jak test, bot ani powyższych wartości przykładowych.
• Brak domyślnych wartości bibliotek: Unikaj używania domyślnych nagłówków bibliotek, takich jak python-requests, okhttp, axios, node czy Go-http-client.

Opcje danych kontaktowych:
Dane kontaktowe nie muszą być tradycyjną stroną internetową. Każda z poniższych opcji jest akceptowalnym sposobem identyfikacji:

• Bezpośredni adres e-mail do kontaktu.
• Strona internetowa projektu lub publiczne repozytorium (np. GitHub, GitLab).
• Link zaproszenia bota lub strona informacyjna.
• Link z listingu (np. top.gg lub podobne katalogi).

Podszywanie się i fałszowanie:

• Nie fałszuj ciągów znaków przeglądarek. Format Mozilla/5.0 ... jest zarezerwowany wyłącznie dla prawdziwych przeglądarek internetowych oraz botów zweryfikowanych przez Cloudflare.
• Nie podszywaj się pod znane roboty indeksujące, takie jak Googlebot czy Bingbot.

Niezastosowanie się do tych wytycznych oraz używanie wartości ogólnych, domyślnych lub sfałszowanych prawdopodobnie skutkować będzie zablokowaniem Twoich zapytań.

Kategorie

Kategorie określają typ treści zwracanych przez API. Każda kategoria jest przypisana do stałego formatu pliku.

Obrazy

husbandokitsunenekowaifu

GIF-y

angrybakabiteblehblowkissblushbonkboredcarryclapconfusedcrycuddledancefacepalmfeedhandholdhandshakehappyhighfivehugkabedonkickkisslappillowlaughlurknodnomnopenyapatpeckpokepoutpunchrunsaluteshakeshootshockedshrugsipslapsleepsmilesmugspinstaretableflipteeheethinkthumbsupticklewagwavewinkyawnyeet

Pola odpowiedzi

Typ	Pola
Obrazy	artist_name, artist_href, source_url
GIF-y	anime_name

Pola url oraz dimensions są zawarte w obu typach.