Miruro Proxy API

REST API for anime data. This proxy bridges your frontend to miruro.tv's internal pipe API.

Endpoints

GET /api/anime/182300

Returns full anime metadata (info from AniList + pipe API).

GET /api/anime/182300/episodes?provider=kiwi

Returns episode list with provider-specific IDs. Supports provider query param (default: kiwi).

GET /api/anime/182300/episodes/1?provider=kiwi&category=sub

Returns streaming sources for a specific episode. Supports provider and category params.

GET /api/trending?page=1&perPage=20

Trending anime (AniList GraphQL).

GET /api/popular?page=1&perPage=20

Most popular anime (AniList GraphQL).

GET /api/recent?page=1&perPage=20

Currently airing / recently updated anime (AniList GraphQL).

GET /api/search?q=Wistoria

Search anime by title (AniList GraphQL). Supports page and perPage params.

GET /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.

GET /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.

GET /api/schedule

Today's anime airing schedule with full anime metadata and airing times.

GET /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.

GET /api/health

Health check: server status, uptime, cache size, thread pool config, rate limit.

Providers

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.

Example

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