API-Dokumentation

Integriere die Anime-Screenshot-Suche mit unserer öffentlichen API.

Kostenloses Kontingent

Signed-in users: 10 free credits per day (expire at midnight). After that, 1 credit per search. Upgrade for more.

Hinweise zur Authentifizierung

Sitzungsbasierte Endpunkte erfordern ein gültiges better-auth-Session-Cookie. Bei serverseitigen oder Nicht-Browser-Clients müssen Sie den Origin-Header senden (z. B. Origin: https://your-domain.com) und das von /api/auth/sign-in/email zurückgegebene Cookie speichern.

POST/api/anime/search
Suche nach einer Anime-Szene durch Hochladen einer Bilddatei oder Angabe einer Bild-URL. Liefert bis zu 5 Treffer mit Zeitstempeln und Ähnlichkeitswerten.
Authentifizierung: Session oder API-Key

Parameter

NameTypErforderlichBeschreibung
imageFileNeinBilddatei (JPEG/PNG)
urlstringNeinÖffentliche Bild-URL

Guests: 5/day by IP. Signed-in users: 10 daily free credits, then 1 credit per search, 100/hour.

Example

curl -X POST https://whatanimeisthis.com/api/anime/search \
  -F "url=https://example.com/screenshot.png"
curl -X POST https://whatanimeisthis.com/api/anime/search \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -F "url=https://example.com/screenshot.png"
GET/api/anime/rankings
Hole die am häufigsten gesuchten Anime-Rankings nach Zeitraum.
Authentifizierung: Keine

Parameter

NameTypErforderlichBeschreibung
periodstringNeindaily | weekly | monthly | yearly | all (Standard: all)
limitnumberNeinMax. Ergebnisse (Standard: 50)
includeAdultbooleanNeinNSFW-Einträge einschließen (Standard: false)

Keine Authentifizierung erforderlich.

Example

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"
GET/api/anime/recent-searches
Hole kürzlich bestätigte öffentliche Suchen.
Authentifizierung: Keine

Parameter

NameTypErforderlichBeschreibung
limitnumberNeinMax. Ergebnisse
offsetnumberNeinPaginierungs-Offset

Öffentlicher Endpunkt.

Example

curl "https://whatanimeisthis.com/api/anime/recent-searches?limit=5"
GET/api/user/anime-credits
Hole die verbleibenden Anime-Such-Credits des angemeldeten Nutzers.
Authentifizierung: Session

Nur für angemeldete Nutzer.

Example

curl "https://whatanimeisthis.com/api/user/anime-credits" \
  -H "Cookie: <SESSION_COOKIE>"
GET/api/apikeys
Liste deine API-Keys auf.
Authentifizierung: Session

Parameter

NameTypErforderlichBeschreibung
pagenumberNeinSeitennummer
pageSizenumberNeinEinträge pro Seite

Nur für angemeldete Nutzer.

Example

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"
POST/api/apikeys
Erstelle einen neuen API-Key. Der Klartext-Key wird nur einmal zurückgegeben.
Authentifizierung: Session

Parameter

NameTypErforderlichBeschreibung
titlestringJaBeschreibender Name für den Key

Nur für angemeldete Nutzer.

Example

curl -X POST https://whatanimeisthis.com/api/apikeys \
  -H "Content-Type: application/json" \
  -H "Cookie: <SESSION_COOKIE>" \
  -d '{"title":"my-key"}'