mirror of https://github.com/Shineii86/MiruroAPI.git synced 2026-10-22 02:05:10 +00:00

Files

T

Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ c13e0bbd7e feat: v1.1.0 - Swagger docs, mappings, Docker, premium landing page

- Swagger UI interactive docs at /docs
- OpenAPI 3.0 spec at /openapi.json
- mappings field in episodes response (anilistId, malId, kitsuId)
- Docker support (Dockerfile + .dockerignore)
- Premium landing page with try-it buttons (Walter-style)
- Health endpoint with providers list and endpoint count

2026-06-09 14:16:33 +05:30

2.2 KiB

Raw Blame History

MiruroAPI

Free RESTful API for anime streaming data. Powered by AniList GraphQL and Miruro streaming providers.

Live

API: https://miruroapi-zeta.vercel.app
Docs: https://miruroapi-zeta.vercel.app/docs (Swagger UI)
OpenAPI: https://miruroapi-zeta.vercel.app/openapi.json
GitHub: https://github.com/Shineii86/MiruroAPI

Features

16 API endpoints
AniList GraphQL for metadata (search, trending, info, filter, schedule)
12 streaming providers (kiwi, pewe, bee, bonk, bun, ally, nun, twin, cog, moo, hop, telli)
M3U8 streaming URLs with subtitles and skip timestamps
In-memory caching with TTL
CORS enabled
Swagger UI interactive docs
Docker support
Health endpoint

Endpoints

Search & Discovery

Endpoint	Description
`GET /api/search?query=naruto`	Search anime by name
`GET /api/suggestions?query=naruto`	Autocomplete suggestions
`GET /api/filter?genre=Action`	Advanced filter

Collections

Endpoint	Description
`GET /api/trending`	Trending anime
`GET /api/popular`	Most popular anime
`GET /api/upcoming`	Upcoming anime
`GET /api/recent`	Currently airing anime
`GET /api/spotlight`	Spotlight/featured anime
`GET /api/schedule`	Airing schedule

Anime Details

Endpoint	Description
`GET /api/info/:id`	Full anime info by AniList ID
`GET /api/anime/:id/characters`	Characters with voice actors
`GET /api/anime/:id/relations`	Related anime
`GET /api/anime/:id/recommendations`	Recommendations

Streaming

Endpoint	Description
`GET /api/episodes/:id`	Episode list from all providers
`GET /api/sources?episodeId=...&provider=...&anilistId=...`	Streaming sources (detailed)
`GET /api/watch/:provider/:anilistId/:category/:slug`	Streaming sources (simple)

Streaming Flow

GET /api/episodes/:anilistId — get episode list with provider IDs
GET /api/watch/:provider/:anilistId/:category/:slug — get M3U8 URL
Play M3U8 in any HLS player

Setup

npm install
npm start

Docker

docker build -t miruroapi .
docker run -p 3000:3000 miruroapi

License

MIT

2.2 KiB Raw Blame History