Documentazione API

Integra la ricerca per screenshot anime nella tua app con la nostra API pubblica.

Quota gratuita

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

Note sull'autenticazione

Gli endpoint basati su sessione richiedono un cookie di sessione better-auth valido. Se chiamati da server o client non browser, includere l'header Origin (es. Origin: https://your-domain.com) e conservare il cookie restituito da /api/auth/sign-in/email.

POST/api/anime/search
Cerca una scena anime caricando un file immagine o fornendo un URL immagine. Restituisce fino a 5 corrispondenze con timestamp e punteggi di similarità.
Autenticazione: Session o API key

Parametri

NomeTipoRichiestoDescrizione
imageFileNoFile immagine (JPEG/PNG)
urlstringNoURL immagine pubblica

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
Recupera la classifica degli anime più cercati per periodo.
Autenticazione: Nessuna

Parametri

NomeTipoRichiestoDescrizione
periodstringNodaily | weekly | monthly | yearly | all (predefinito: all)
limitnumberNoRisultati max (predefinito: 50)
includeAdultbooleanNoIncludi voci NSFW (predefinito: false)

Nessuna autenticazione richiesta.

Example

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"
GET/api/anime/recent-searches
Recupera ricerche pubbliche recentemente confermate.
Autenticazione: Nessuna

Parametri

NomeTipoRichiestoDescrizione
limitnumberNoRisultati max
offsetnumberNoOffset paginazione

Endpoint pubblico.

Example

curl "https://whatanimeisthis.com/api/anime/recent-searches?limit=5"
GET/api/user/anime-credits
Ottieni i crediti di ricerca anime rimanenti dell'utente registrato.
Autenticazione: Session

Solo utenti registrati.

Example

curl "https://whatanimeisthis.com/api/user/anime-credits" \
  -H "Cookie: <SESSION_COOKIE>"
GET/api/apikeys
Elenca le tue API key.
Autenticazione: Session

Parametri

NomeTipoRichiestoDescrizione
pagenumberNoNumero di pagina
pageSizenumberNoElementi per pagina

Solo utenti registrati.

Example

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"
POST/api/apikeys
Crea una nuova API key. La chiave in chiaro viene restituita solo una volta.
Autenticazione: Session

Parametri

NomeTipoRichiestoDescrizione
titlestringNome descrittivo per la key

Solo utenti registrati.

Example

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