Miruro API v2.0

The ultimate, decrypted, and fully reverse-engineered native Python backend for Miruro.

https://github.com/walterwhite-69/Miruro-API

What This Does

Miruro's frontend communicates with its backend through a secure/pipe tunnel that base64-encodes, gzip-compresses, and encrypts every request. This project bypasses all of that and gives you simple, direct REST endpoints to:

1. Search & filter anime with full AniList metadata
2. Get complete anime info — characters, staff, relations, recommendations, trailer, stats, and all metadata in one request
3. Browse collections — trending, popular, upcoming, recent, schedule, and spotlight — all paginated
4. List episodes with decoded episode IDs from multiple providers
5. Get M3U8 streaming URLs for any episode
6. Autocomplete search suggestions for dropdown UIs

No headless browsers, no Selenium — just lightweight async HTTP requests.

All Endpoints

🔍 Search & Discovery

Filter Parameters

📊 Collections (All Paginated)

All collection endpoints accept page and per_page query params and return:

{
  "page": 1,
  "perPage": 20,
  "total": 5000,
  "hasNextPage": true,
  "results": [ ... ]
}

Each anime in results includes 20+ fields: title (romaji/english/native), coverImage, bannerImage, format, season, seasonYear, episodes, duration, status, averageScore, meanScore, popularity, favourites, genres, source, countryOfOrigin, studios, nextAiringEpisode, startDate, endDate, and more.

📖 Anime Details

What /info/{id} Returns

Everything you need to build a full anime detail page:

• Core: id, idMal, title (romaji/english/native), description, coverImage, bannerImage
• Metadata: format, season, seasonYear, episodes, duration, status, source, countryOfOrigin
• Scores: averageScore, meanScore, popularity, favourites, trending
• Taxonomy: genres, tags (with rank & spoiler flag), synonyms, hashtag
• People: characters (25, with voice actors), staff (25, with roles)
• Related: relations (sequels/prequels/etc.), recommendations (10, with ratings)
• Media: trailer (YouTube/Dailymotion), streamingEpisodes, externalLinks
• Stats: scoreDistribution, statusDistribution
• Studios: name, isAnimationStudio, siteUrl
• Dates: startDate, endDate, nextAiringEpisode
• Links: siteUrl, externalLinks (MAL, official site, etc.)

▶️ Streaming (3-Step Flow)

To get a video stream, follow these 3 steps in order:

Step 1: Get Episodes — GET /episodes/{anilist_id}

Returns all episodes from multiple providers (kiwi, arc, zoro, jet, etc.) organized by audio type.

{
  "mappings": { "anilistId": 178005, "malId": 56885, "kitsuId": ... },
  "providers": {
    "kiwi": {
      "episodes": {
        "sub": [
          {
            "id": "watch/kiwi/178005/sub/animepahe-1",
            "number": 1,
            "title": "Episode Title",
            "image": "https://serveproxy.com/url?url=...",
            "airDate": "2026-01-04",
            "duration": 1420,
            "description": "...",
            "filler": false
          }
        ],
        "dub": [ ... ]
      }
    },
    "arc": { ... },
    "zoro": { ... }
  }
}

Step 2: Get Sources [SUPER SIMPLE]

Just take the direct id from the Step 1 response and use it as the URL. No manual parameters or complex IDs needed!

Endpoint: GET /{id} Example: GET /watch/kiwi/178005/sub/animepahe-1

{
  "streams": [
    { "url": "https://.../master.m3u8", "type": "hls", "quality": "1080p" }
  ],
  "subtitles": [
    { "file": "https://...", "label": "English", "kind": "captions" }
  ],
  "intro": { "start": 0, "end": 90 },
  "outro": { "start": 1300, "end": 1420 }
}

[!TIP] This endpoint automatically handles decryption, provider selection, and category matching. It returns the direct M3U8/HLS streaming URL and intro/outro timestamps.

Step 3: Play

Feed streams[0].url into any HLS player (Video.js, hls.js, VLC, mpv). Subtitles are either hard-subbed (baked into the video for kiwi/pahe) or provided in the subtitles array (VTT links for zoro/arc). Use intro/outro timestamps for skip buttons.

Setup

git clone https://github.com/walterwhite-69/Miruro-API.git
cd Miruro-API
pip install -r requirements.txt  
uvicorn api:app --host 0.0.0.0 --port 8000

Then open http://localhost:8000/ for interactive API docs.

Disclaimer

This project is for educational purposes and API integrity research only. The author takes absolutely zero responsibility for network usage. Code contains zero skiddable artifacts.

Author: Walter | GitHub: walterwhite-69