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

Name	Typ	Erforderlich	Beschreibung
image	File	Nein	Bilddatei (JPEG/PNG)
url	string	Nein	Ö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

Name	Typ	Erforderlich	Beschreibung
period	string	Nein	daily \| weekly \| monthly \| yearly \| all (Standard: all)
limit	number	Nein	Max. Ergebnisse (Standard: 50)
includeAdult	boolean	Nein	NSFW-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

Name	Typ	Erforderlich	Beschreibung
limit	number	Nein	Max. Ergebnisse
offset	number	Nein	Paginierungs-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

Name	Typ	Erforderlich	Beschreibung
page	number	Nein	Seitennummer
pageSize	number	Nein	Einträ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

Name	Typ	Erforderlich	Beschreibung
title	string	Ja	Beschreibender 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"}'