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

Nome	Tipo	Richiesto	Descrizione
image	File	No	File immagine (JPEG/PNG)
url	string	No	URL 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

Nome	Tipo	Richiesto	Descrizione
period	string	No	daily \| weekly \| monthly \| yearly \| all (predefinito: all)
limit	number	No	Risultati max (predefinito: 50)
includeAdult	boolean	No	Includi 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

Nome	Tipo	Richiesto	Descrizione
limit	number	No	Risultati max
offset	number	No	Offset 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

Nome	Tipo	Richiesto	Descrizione
page	number	No	Numero di pagina
pageSize	number	No	Elementi 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

Nome	Tipo	Richiesto	Descrizione
title	string	Sì	Nome 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"}'