Anime Episode Finder

Anime Episode Finder API

Pass an Anilist, MAL, or Simkl ID. Get metadata, artworks, and episode lists.

GET /api/{anilist_id}GET /api?mal_id={id}GET /api?simkl_id={id}
Endpoint:
Enter an ID and search.
API Documentation

Endpoints

GET /api/{anilist_id} — basic
GET /api?mal_id={id} — basic
GET /api?simkl_id={id} — basic
GET /api/episodes/{anilist_id} — rich
GET /api/episodes?mal_id={id} — rich
GET /api/episodes?simkl_id={id} — rich

Rate Limit

Configurable via RATE_LIMIT_MAX env var

Window: RATE_LIMIT_WINDOW (seconds, default 60)

429 + Retry-After when exceeded

/api/health is exempt

CORS

Access-Control-Allow-Origin: *

OPTIONS → 204 No Content

Methods: GET, OPTIONS

Rich Endpoint Fields

FieldDescription
mal_idMyAnimeList ID
anilist_idAnilist ID
simkl_idSimkl ID
tvdb_idTVDB series ID
tmdb_idTMDB ID
titleEnglish title
title_simklOriginal title (Romanji)
artworksposter, fanart, clear_logo, banner
episodes.list[]All aired episodes with stills (3 sizes), TVDB mapping
list[].still_url_w600×338px (~21 KB)
list[].still_url_c210×118px (~7 KB)
list[].still_url_m112×84px (~3 KB)
list[].tvdb_seasonTVDB season number
episodes.first_airedEpisode 1 details
episodes.last_airedMost recent aired episode
episodes.next_scheduledNext upcoming (ongoing only)

Basic Endpoint Fields

FieldDescription
first_aired_episodeEpisode 1 — number, title, date
last_aired_episodeMost recent aired episode
next_scheduled_episodeNext upcoming (ongoing only)
specials_countNon-regular episodes count