Documentación de la API

Integra la búsqueda de capturas de anime en tu app con nuestra API pública.

Cuota gratuita

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

Notas de autenticación

Los endpoints basados en sesión requieren una cookie de sesión válida de better-auth. Al llamar desde el servidor o clientes no navegador, incluye el header Origin (p. ej. Origin: https://your-domain.com) y guarda la cookie devuelta por /api/auth/sign-in/email.

POST/api/anime/search
Busca una escena de anime subiendo un archivo de imagen o proporcionando una URL de imagen. Devuelve hasta 5 coincidencias con marcas de tiempo y puntajes de similitud.
Autenticación: Sesión o API key

Parámetros

NombreTipoRequeridoDescripción
imageFileNoArchivo de imagen (JPEG/PNG)
urlstringNoURL de imagen pública

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
Obtén el ranking de anime más buscado por período.
Autenticación: Ninguna

Parámetros

NombreTipoRequeridoDescripción
periodstringNodaily | weekly | monthly | yearly | all (predeterminado: all)
limitnumberNoMáx. resultados (predeterminado: 50)
includeAdultbooleanNoIncluir entradas NSFW (predeterminado: false)

No requiere autenticación.

Example

curl "https://whatanimeisthis.com/api/anime/rankings?period=daily&limit=10"
GET/api/anime/recent-searches
Obtén búsquedas públicas recientemente confirmadas.
Autenticación: Ninguna

Parámetros

NombreTipoRequeridoDescripción
limitnumberNoMáx. resultados
offsetnumberNoOffset de paginación

Endpoint público.

Example

curl "https://whatanimeisthis.com/api/anime/recent-searches?limit=5"
GET/api/user/anime-credits
Obtén los créditos de búsqueda de anime restantes del usuario registrado.
Autenticación: Sesión

Solo usuarios registrados.

Example

curl "https://whatanimeisthis.com/api/user/anime-credits" \
  -H "Cookie: <SESSION_COOKIE>"
GET/api/apikeys
Lista tus API keys.
Autenticación: Sesión

Parámetros

NombreTipoRequeridoDescripción
pagenumberNoNúmero de página
pageSizenumberNoElementos por página

Solo usuarios registrados.

Example

curl "https://whatanimeisthis.com/api/apikeys" \
  -H "Cookie: <SESSION_COOKIE>"
POST/api/apikeys
Crea una nueva API key. La clave de texto se devuelve solo una vez.
Autenticación: Sesión

Parámetros

NombreTipoRequeridoDescripción
titlestringNombre descriptivo para la key

Solo usuarios registrados.

Example

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