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

Nom	Type	Requis	Description
image	File	Non	Fichier image (JPEG/PNG)
url	string	Non	URL 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

Nom	Type	Requis	Description
period	string	Non	daily \| weekly \| monthly \| yearly \| all (défaut : all)
limit	number	Non	Résultats max (défaut : 50)
includeAdult	boolean	Non	Inclure 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

Nom	Type	Requis	Description
limit	number	Non	Résultats max
offset	number	Non	Offset 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

Nom	Type	Requis	Description
page	number	Non	Numéro de page
pageSize	number	Non	É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

Nom	Type	Requis	Description
title	string	Oui	Nom 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"}'