Documentation API

Intégrez la recherche de captures d'anime dans votre app avec notre API publique.

Quota gratuit

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

Notes d'authentification

Les endpoints en session nécessitent un cookie de session better-auth valide. Depuis le serveur ou un client non-navigateur, incluez l'en-tête Origin (ex. Origin: https://your-domain.com) et conservez le cookie renvoyé par /api/auth/sign-in/email.

POST/api/anime/search
Recherchez une scène d'anime en téléchargeant un fichier image ou en fournissant une URL d'image. Renvoie jusqu'à 5 correspondances avec horodatages et scores de similarité.
Authentification: Session ou clé API

Paramètres

NomTypeRequisDescription
imageFileNonFichier image (JPEG/PNG)
urlstringNonURL d'image publique

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
Récupérez le classement des animes les plus recherchés par période.
Authentification: Aucune

Paramètres

NomTypeRequisDescription
periodstringNondaily | weekly | monthly | yearly | all (défaut : all)
limitnumberNonRésultats max (défaut : 50)
includeAdultbooleanNonInclure les entrées NSFW (défaut : false)

Aucune authentification requise.

Example

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"
GET/api/anime/recent-searches
Récupérez les recherches publiques récemment confirmées.
Authentification: Aucune

Paramètres

NomTypeRequisDescription
limitnumberNonRésultats max
offsetnumberNonOffset de pagination

Endpoint public.

Example

curl "https://whatanimeisthis.com/api/anime/recent-searches?limit=5"
GET/api/user/anime-credits
Obtenez les crédits de recherche d'anime restants de l'utilisateur connecté.
Authentification: Session

Utilisateurs connectés uniquement.

Example

curl "https://whatanimeisthis.com/api/user/anime-credits" \
  -H "Cookie: <SESSION_COOKIE>"
GET/api/apikeys
Liste vos clés API.
Authentification: Session

Paramètres

NomTypeRequisDescription
pagenumberNonNuméro de page
pageSizenumberNonÉléments par page

Utilisateurs connectés uniquement.

Example

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"
POST/api/apikeys
Créez une nouvelle clé API. La clé en clair est renvoyée une seule fois.
Authentification: Session

Paramètres

NomTypeRequisDescription
titlestringOuiNom descriptif pour la clé

Utilisateurs connectés uniquement.

Example

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