Documentación de la API de búsqueda de anime

Integra la búsqueda de capturas de anime en tu app con la API pública. Identifica animes, episodios y marcas de tiempo de forma programática con simples peticiones HTTP.

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

Nombre	Tipo	Requerido	Descripción
image	File	No	Archivo de imagen (JPEG/PNG)
url	string	No	URL 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

Nombre	Tipo	Requerido	Descripción
period	string	No	daily \| weekly \| monthly \| yearly \| all (predeterminado: all)
limit	number	No	Máx. resultados (predeterminado: 50)
includeAdult	boolean	No	Incluir 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

Nombre	Tipo	Requerido	Descripción
limit	number	No	Máx. resultados
offset	number	No	Offset 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

Nombre	Tipo	Requerido	Descripción
page	number	No	Número de página
pageSize	number	No	Elementos 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

Nombre	Tipo	Requerido	Descripción
title	string	Sí	Nombre 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"}'