REST API for anime and movie data. This proxy bridges your frontend to miruro.tv's internal pipe API + movie streaming providers.
/api/anime/182300
Returns full anime metadata (info from AniList + pipe API).
/api/anime/182300/episodes?provider=kiwi
Returns episode list with provider-specific IDs. Supports provider query param (default: kiwi).
/api/anime/182300/episodes/1?provider=kiwi&category=sub
Returns streaming sources for a specific episode. Supports provider and category params.
/api/trending?page=1&perPage=20
Trending anime (AniList GraphQL).
/api/popular?page=1&perPage=20
Most popular anime (AniList GraphQL).
/api/recent?page=1&perPage=20
Currently airing / recently updated anime (AniList GraphQL).
/api/search?q=Wistoria
Search anime by title (AniList GraphQL). Supports page and perPage params.
/api/searchv2?sort=POPULARITY_DESC&genres=Action&format=TV&status=FINISHED
Advanced search with filters. Supports sort, type, format, status, genres, tags, year, limit, offset.
/api/browse?season=SPRING&seasonYear=2026&sort=TRENDING_DESC&page=1&perPage=20
Browse seasonal anime with sorting. Supports season (WINTER/SPRING/SUMMER/FALL), seasonYear, sort, format, status, genres, tags, search, endDate_greater, startDate_lesser.
/api/schedule
Today's anime airing schedule with full anime metadata and airing times.
/api/stream?url={base64url}
HLS stream proxy. Fetches M3U8 playlists and TS segments from the CDN with proper Referer headers and CORS.
The url param is a base64url-encoded CDN URL. Used automatically by hls.js when you point it
at a /api/stream?url=... playlist URL.
/api/movie/{tmdb_id}
Extracts movie streaming URL from 2embed.cc → uqloads.xyz pipeline.
Returns {"provider": "2embed.cc (uqloads)", "url": "...", "referer": "..."}.
/api/tv/{tmdb_id}?s={season}&e={episode}
Extracts TV episode streaming URL from vidlink.pro.
Returns {"provider": "vidlink.pro", "url": "...", "referer": "...", "captions": [...]}.
Query params s and e default to 1.
/api/movie/proxy?url={url}&ref={referer}
Proxies movie M3U8 playlists and TS/.woff2 segments with proper Referer headers. Use this after getting a stream URL from /api/movie/{id}.
/api/tv/proxy?url={url}&ref={referer}
Proxies TV M3U8 playlists and TS segments with proper Referer headers. Identical to /api/movie/proxy. Use this after getting a stream URL from /api/tv/{id}.
/api/movie/trending
Trending movies today. Returns {"total": N, "page": 1, "results": [...]}. Results include id, title, type, year, rating, poster, backdrop.
/api/movie/popular
Popular movies (all-time). Same format as trending.
/api/movie/top_rated
Top-rated movies.
/api/movie/now_playing
Movies currently in theaters.
/api/movie/upcoming
Upcoming movies.
/api/movie/search?q={query}&page={page}
Search movies and TV shows by title. Uses TMDB multi search.
/api/movie/discover?genre={genre_id}&sort={sort_by}&page={page}
Discover movies by genre (e.g. 28 for Action, 878 for Sci-Fi).
Default sort: popularity.desc. Use /api/genres?type=movie to get genre IDs.
/api/tv/trending /api/tv/popular /api/tv/airing_today /api/tv/on_the_air
TV show discovery endpoints. Same response format as movie discovery.
/api/genres?type=movie|tv
Returns genre list with IDs: {"genres": [{"id": 28, "name": "Action"}, ...]}.
/api/health
Health check: server status, uptime, cache size, thread pool config, rate limit.
Supported providers: kiwi (default), arc, bee, ally, dune, hop.
Categories: sub (default, hardsubbed), dub (dubbed), ssub (softsub — separate subtitle tracks, supported by arc & bee), sdub (softsub dub).
The ssub/sdub categories return subtitles in the response — VTT or ASS tracks for frontend rendering.
Provider: 2embed.cc (uqloads) — 2embed → uqloads.xyz → JS unpack → m3u8 (HD, no auth).
Fallback: vidsrc.rip — XOR VRF token → m3u8.
Pipelines run in parallel; first verified reachable URL wins.
Provider: vidlink.pro — enc-dec.app encryption → vidlink.pro JSON API → m3u8 + subtitles.
# Anime
curl http://localhost:8000/api/anime/182300/episodes/1?provider=kiwi&category=sub
curl http://localhost:8000/api/anime/182300/episodes/1?provider=bee&category=ssub
# Discovery
curl http://localhost:8000/api/movie/trending
curl http://localhost:8000/api/movie/search?q=backrooms
curl http://localhost:8000/api/movie/discover?genre=28&sort=vote_average.desc
curl http://localhost:8000/api/tv/popular
curl http://localhost:8000/api/genres?type=movie
# Movie stream
curl http://localhost:8000/api/movie/454639
# → {"provider":"2embed.cc (uqloads)","url":"https://...master.txt","referer":"https://uqloads.xyz/"}
# TV stream
curl "http://localhost:8000/api/tv/1396?s=1&e=1"
# → {"provider":"vidlink.pro","url":"https://...m3u8","referer":"https://vidlink.pro/","captions":[...]}
# Play movie/TV stream:
# hls.js → /api/movie/proxy?url={encoded_url}&ref={encoded_referer}
# hls.js → /api/tv/proxy?url={encoded_url}&ref={encoded_referer}