mirror of
https://github.com/Shineii86/MiruroAPI.git
synced 2026-10-22 10:15:10 +00:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
 Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
|
3ab0bae18d | ||
|
Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
|
33e5e8e136 | ||
|
Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
|
3675bbba77 | ||
|
Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
|
9ada6e1016 | ||
|
Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
|
3a28c4d182 | ||
|
Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
|
68f7ea7cf4 | ||
|
Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
|
37e70c3bda | ||
|
Sʜɪɴᴇɪ Nᴏᴜᴢᴇɴ
|
af08c91624 |
+80
-6
@@ -1,5 +1,79 @@
|
|||||||
# Changelog
|
# Changelog
|
||||||
|
|
||||||
|
## v2.0.0
|
||||||
|
### Major Release — 35 endpoints, streaming improvements, new features
|
||||||
|
|
||||||
|
#### Technical Foundation
|
||||||
|
- Added gzip compression middleware (30-70% response size reduction)
|
||||||
|
- Added request logging with method, path, status, duration, IP
|
||||||
|
- Added Cache-Control headers for API responses (varies by endpoint type)
|
||||||
|
- Improved CORS with preflight caching (24h max-age)
|
||||||
|
- Health endpoint now includes memory stats (heap, RSS), cache size, node version
|
||||||
|
|
||||||
|
#### New AniList Helpers (11 new functions)
|
||||||
|
- getAllGenres — complete genre list from AniList
|
||||||
|
- getAllTags — complete tag list with metadata
|
||||||
|
- getTopAnime — top-rated anime of all time (SCORE_DESC)
|
||||||
|
- getTrendingDaily — trending anime (last 7 days)
|
||||||
|
- getTrendingWeekly — trending anime (last 30 days)
|
||||||
|
- getSeasonalAnime — anime by year + season (e.g., 2025/Spring)
|
||||||
|
- getAnimeByStudio — anime produced by a specific studio
|
||||||
|
- getCharacterInfo — character detail with anime list
|
||||||
|
- getStaffInfo — staff detail with anime list
|
||||||
|
- searchCharacters — search characters by name
|
||||||
|
- searchStaff — search staff by name
|
||||||
|
|
||||||
|
#### New Streaming & Download Features
|
||||||
|
- extractSubtitles — extract subtitle URLs from sources
|
||||||
|
- getBestStream — automatic quality fallback (1080p → 720p → 360p)
|
||||||
|
- getDownloadUrl — dedicated download URL endpoint
|
||||||
|
- getBatchSources — fetch multiple episode sources in parallel
|
||||||
|
|
||||||
|
#### New API Endpoints (17 new)
|
||||||
|
- GET /api/trending/daily — daily trending anime
|
||||||
|
- GET /api/trending/weekly — weekly trending anime
|
||||||
|
- GET /api/top — top anime by score
|
||||||
|
- GET /api/random — random anime of the day
|
||||||
|
- GET /api/multi-search — combined query + filters
|
||||||
|
- GET /api/season/:year/:season — seasonal anime
|
||||||
|
- GET /api/studio/:name — anime by studio
|
||||||
|
- GET /api/genres — all genres list
|
||||||
|
- GET /api/tags — all tags list
|
||||||
|
- GET /api/genre/:name — anime by genre
|
||||||
|
- GET /api/year/:year — anime by year
|
||||||
|
- GET /api/status/:status — anime by status
|
||||||
|
- GET /api/format/:format — anime by format
|
||||||
|
- GET /api/character/:id — character detail
|
||||||
|
- GET /api/staff/:id — staff detail
|
||||||
|
- GET /api/characters — search characters
|
||||||
|
- GET /api/staff — search staff
|
||||||
|
- GET /api/episodes/:id/batch — batch episode sources
|
||||||
|
- GET /api/stream — streaming with quality fallback
|
||||||
|
- GET /api/download — download URL
|
||||||
|
- GET /api/compare/:id1/:id2 — compare two anime
|
||||||
|
- GET /api/stats/genre — genre statistics
|
||||||
|
- GET /api/calendar — monthly airing calendar
|
||||||
|
- GET /api/timeline/:id — anime release timeline
|
||||||
|
|
||||||
|
#### Streaming Improvements
|
||||||
|
- Subtitle URL extraction from pipe responses
|
||||||
|
- Quality fallback: tries 1080p → 720p → 480p → 360p automatically
|
||||||
|
- Batch episode fetching (up to 5 parallel requests)
|
||||||
|
- Dedicated download endpoint with provider metadata
|
||||||
|
- Cache headers: episodes/sources (2min), info (5min), genres/tags (24h)
|
||||||
|
|
||||||
|
#### Version synced to 2.0.0 across all files
|
||||||
|
|
||||||
|
## v1.4.0
|
||||||
|
- Added creator attribution middleware — injects author info into every response
|
||||||
|
- Fixed Vercel deployment: replaced legacy `builds`/`routes` config with modern `functions` config
|
||||||
|
- Added `api/index.js` serverless entry point
|
||||||
|
- Security headers: removed deprecated `X-XSS-Protection`, added `Strict-Transport-Security` (HSTS)
|
||||||
|
- Rate limiter: uses `x-forwarded-for` header for correct IP detection on Vercel
|
||||||
|
- Rate limiter: added periodic IP entry pruning when >200 IPs tracked
|
||||||
|
- Cache: added periodic expired entry cleanup when cache reaches 80% capacity
|
||||||
|
- Version synced to 1.4.0
|
||||||
|
|
||||||
## v1.3.0
|
## v1.3.0
|
||||||
- Full landing page upgrade to match AniKotoAPI style
|
- Full landing page upgrade to match AniKotoAPI style
|
||||||
- Added canvas particle effects with cyan-colored floating particles
|
- Added canvas particle effects with cyan-colored floating particles
|
||||||
@@ -7,18 +81,18 @@
|
|||||||
- Added animated stat counters that count up on scroll
|
- Added animated stat counters that count up on scroll
|
||||||
- Added infinite scrolling marquee with 8 feature badges
|
- Added infinite scrolling marquee with 8 feature badges
|
||||||
- Added live interactive API console with 5 preset endpoint buttons
|
- Added live interactive API console with 5 preset endpoint buttons
|
||||||
- Added sidebar endpoint explorer with 16 endpoints and multi-language code tabs (cURL, JavaScript, Python)
|
- Added sidebar endpoint explorer with 16 endpoints and multi-language code tabs
|
||||||
- Added 4 interactive playground cards (Search, Info, Episodes, Trending)
|
- Added 4 interactive playground cards (Search, Info, Episodes, Trending)
|
||||||
- Added custom scrollbar styling
|
- Added custom scrollbar styling
|
||||||
- Added JetBrains Mono font for code blocks
|
- Added JetBrains Mono font for code blocks
|
||||||
- Added 4-column grid footer with API, Resources, Legal sections
|
- Added 4-column grid footer
|
||||||
- Added fixed header with scroll-aware blur/glass effect
|
- Added fixed header with scroll-aware blur/glass effect
|
||||||
- Added ambient orb gradient animations
|
- Added ambient orb gradient animations
|
||||||
- Added CTA section with gradient overlay
|
- Added CTA section with gradient overlay
|
||||||
- Color scheme updated to match MiruroAPI brand (cyan #38bdf8 + indigo #818cf8)
|
- Color scheme updated to match MiruroAPI brand (cyan #38bdf8 + indigo #818cf8)
|
||||||
- All branding updated: AniKotoAPI references → MiruroAPI
|
- All branding updated: AniKotoAPI references → MiruroAPI
|
||||||
- OG/Twitter meta tags updated for mirurotvapi.vercel.app
|
- OG/Twitter meta tags updated for mirurotvapi.vercel.app
|
||||||
- JSON-LD structured data updated with image, category, programmingModel
|
- JSON-LD structured data updated
|
||||||
- Real Miruro SVG favicons used in header and footer
|
- Real Miruro SVG favicons used in header and footer
|
||||||
|
|
||||||
## v1.2.0
|
## v1.2.0
|
||||||
@@ -26,14 +100,14 @@
|
|||||||
- Root cause: createApiRoutes() had (app, jsonResponse, jsonError) but was called with (jsonResponse, jsonError), shifting all params
|
- Root cause: createApiRoutes() had (app, jsonResponse, jsonError) but was called with (jsonResponse, jsonError), shifting all params
|
||||||
- Every jsonResponse() call was actually calling jsonError(), returning {success: false, message: data}
|
- Every jsonResponse() call was actually calling jsonError(), returning {success: false, message: data}
|
||||||
- Health endpoint worked because it used res.json() directly, bypassing the wrapper
|
- Health endpoint worked because it used res.json() directly, bypassing the wrapper
|
||||||
- All 18 endpoints verified working: health, stats, search, suggestions, filter, trending, popular, upcoming, recent, spotlight, schedule, info, characters, relations, recommendations, episodes, watch
|
- All 18 endpoints verified working
|
||||||
|
|
||||||
## v1.1.0
|
## v1.1.0
|
||||||
- Added Swagger UI interactive docs at /docs
|
- Added Swagger UI interactive docs at /docs
|
||||||
- Added OpenAPI 3.0 spec at /openapi.json
|
- Added OpenAPI 3.0 spec at /openapi.json
|
||||||
- Added mappings field in episodes response (anilistId, malId, kitsuId)
|
- Added mappings field in episodes response
|
||||||
- Added Docker support (Dockerfile + .dockerignore)
|
- Added Docker support (Dockerfile + .dockerignore)
|
||||||
- Improved landing page with premium design (Walter-style)
|
- Improved landing page with premium design
|
||||||
- Added "Try it" buttons on all endpoints
|
- Added "Try it" buttons on all endpoints
|
||||||
- Health endpoint now includes version, providers list, and endpoint count
|
- Health endpoint now includes version, providers list, and endpoint count
|
||||||
- Version bump to 1.1.0
|
- Version bump to 1.1.0
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
<div align="center">
|
<div align="center">
|
||||||
|
|
||||||
<img src="https://capsule-render.vercel.app/api?type=waving&height=300&color=gradient&text=MiruroAPI&fontAlignY=30&fontSize=90&desc=Free%20Anime%20Streaming%20API&descSize=30" />
|
<img src="https://capsule-render.vercel.app/api?type=waving&height=300&color=gradient&text=𝙈𝙞𝙧𝙪𝙧𝙤𝘼𝙋𝙄&fontAlignY=30&fontSize=100&desc=𝖠%20𝖢𝗈𝗆𝗉𝗅𝖾𝗍𝖾%20𝖱𝖤𝖲𝖳𝖿𝗎𝗅%20𝖠𝖯𝖨%20𝖥𝗈𝗋%20𝖠𝗇𝗂𝗆𝖾%20𝖲𝗍𝗋𝖾𝖺𝗆𝗂𝗇𝗀&descSize=25" />
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -19,15 +19,15 @@
|
|||||||
<img src="https://img.shields.io/badge/AniList-GraphQL-02A6E4?style=flat-square&logo=graphql&logoColor=white" alt="AniList GraphQL"/>
|
<img src="https://img.shields.io/badge/AniList-GraphQL-02A6E4?style=flat-square&logo=graphql&logoColor=white" alt="AniList GraphQL"/>
|
||||||
<img src="https://img.shields.io/badge/Vercel-Serverless-000000?style=flat-square&logo=vercel&logoColor=white" alt="Vercel"/>
|
<img src="https://img.shields.io/badge/Vercel-Serverless-000000?style=flat-square&logo=vercel&logoColor=white" alt="Vercel"/>
|
||||||
<img src="https://img.shields.io/badge/License-MIT-22c55e?style=flat-square&logo=mit&logoColor=white" alt="License"/>
|
<img src="https://img.shields.io/badge/License-MIT-22c55e?style=flat-square&logo=mit&logoColor=white" alt="License"/>
|
||||||
<img src="https://img.shields.io/badge/Version-1.2.0-f43f8e?style=flat-square&logoColor=white" alt="Version"/>
|
<img src="https://img.shields.io/badge/Version-2.0.0-f43f8e?style=flat-square&logoColor=white" alt="Version"/>
|
||||||
<img src="https://img.shields.io/badge/Endpoints-18-6366f1?style=flat-square&logoColor=white" alt="Endpoints"/>
|
<img src="https://img.shields.io/badge/Endpoints-35-6366f1?style=flat-square&logoColor=white" alt="Endpoints"/>
|
||||||
<img src="https://img.shields.io/badge/Providers-12-a855f7?style=flat-square&logoColor=white" alt="Providers"/>
|
<img src="https://img.shields.io/badge/Providers-12-a855f7?style=flat-square&logoColor=white" alt="Providers"/>
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<b>A complete RESTful API for anime streaming data powered by AniList GraphQL and Miruro providers</b><br/>
|
<b>A complete RESTful API for anime streaming data powered by AniList GraphQL and Miruro providers</b><br/>
|
||||||
Search, browse, filter, watch — every endpoint returns fresh data with smart caching.<br/>
|
Search, browse, filter, watch — every endpoint returns fresh data with smart caching.<br/>
|
||||||
18 endpoints, 12 streaming providers, M3U8 URLs with subtitles and skip timestamps.
|
35 endpoints, 12 streaming providers, M3U8 URLs with subtitles, skip timestamps, and batch operations.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
@@ -41,8 +41,7 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
> ## ⚠️ Disclaimer
|
> [!WARNING]
|
||||||
>
|
|
||||||
> 1. This `API` does not store any files — it only links to media hosted on 3rd party services.
|
> 1. This `API` does not store any files — it only links to media hosted on 3rd party services.
|
||||||
> 2. This `API` is explicitly made for **educational purposes only** and not for commercial usage. This repo will not be responsible for any misuse of it.
|
> 2. This `API` is explicitly made for **educational purposes only** and not for commercial usage. This repo will not be responsible for any misuse of it.
|
||||||
> 3. All anime data, images, and content belong to their respective owners (AniList, Miruro). This project is not affiliated with miruro.tv.
|
> 3. All anime data, images, and content belong to their respective owners (AniList, Miruro). This project is not affiliated with miruro.tv.
|
||||||
@@ -85,7 +84,7 @@
|
|||||||
|
|
||||||
### Why MiruroAPI?
|
### Why MiruroAPI?
|
||||||
|
|
||||||
- 🎬 **18 Endpoints** — Complete anime data coverage
|
- 🎬 **35 Endpoints** — Complete anime data coverage
|
||||||
- 🔍 **Full-Text Search** — Search anime by keyword with suggestions
|
- 🔍 **Full-Text Search** — Search anime by keyword with suggestions
|
||||||
- 🎭 **Characters & Voice Actors** — Full character data from AniList
|
- 🎭 **Characters & Voice Actors** — Full character data from AniList
|
||||||
- 🎯 **Advanced Filtering** — Genre, year, season, format, sort
|
- 🎯 **Advanced Filtering** — Genre, year, season, format, sort
|
||||||
@@ -93,6 +92,8 @@
|
|||||||
- 📅 **Airing Schedule** — See what's airing on any date
|
- 📅 **Airing Schedule** — See what's airing on any date
|
||||||
- 📡 **12 Streaming Providers** — M3U8 streaming sources
|
- 📡 **12 Streaming Providers** — M3U8 streaming sources
|
||||||
- ⏭️ **Skip Timestamps** — OP/ED skip data
|
- ⏭️ **Skip Timestamps** — OP/ED skip data
|
||||||
|
- 🎭 **Character & Staff Search** — Search characters and staff by name
|
||||||
|
- 🎬 **Batch Episodes** — Fetch multiple episode sources in parallel
|
||||||
- ⚡ **Smart Caching** — In-memory Map with configurable TTL
|
- ⚡ **Smart Caching** — In-memory Map with configurable TTL
|
||||||
- 🔒 **CORS Enabled** — Works from any frontend, no proxy needed
|
- 🔒 **CORS Enabled** — Works from any frontend, no proxy needed
|
||||||
- 🚀 **Zero-Config Deploy** — One click to Vercel, or run standalone with Express
|
- 🚀 **Zero-Config Deploy** — One click to Vercel, or run standalone with Express
|
||||||
@@ -139,7 +140,9 @@ flowchart TD
|
|||||||
- **AniList GraphQL** for rich metadata
|
- **AniList GraphQL** for rich metadata
|
||||||
- **Miruro pipe** for streaming sources
|
- **Miruro pipe** for streaming sources
|
||||||
- **Smart caching** with configurable TTL
|
- **Smart caching** with configurable TTL
|
||||||
- **18 RESTful endpoints**
|
- **35 RESTful endpoints**
|
||||||
|
- **Gzip compression** — 30-70% smaller responses
|
||||||
|
- **Request logging** — method, path, status, duration
|
||||||
- **Graceful error handling** per endpoint
|
- **Graceful error handling** per endpoint
|
||||||
- **Rate limiting** (100 req/min per IP)
|
- **Rate limiting** (100 req/min per IP)
|
||||||
|
|
||||||
@@ -153,6 +156,9 @@ flowchart TD
|
|||||||
- **Characters** with voice actors
|
- **Characters** with voice actors
|
||||||
- **Relations** and **Recommendations**
|
- **Relations** and **Recommendations**
|
||||||
- **Airing schedule** by date
|
- **Airing schedule** by date
|
||||||
|
- **Seasonal anime** by year + season
|
||||||
|
- **Studio filter** — anime by studio name
|
||||||
|
- **Character & Staff search**
|
||||||
|
|
||||||
</td>
|
</td>
|
||||||
</tr>
|
</tr>
|
||||||
@@ -166,6 +172,9 @@ flowchart TD
|
|||||||
- **Download links** when available
|
- **Download links** when available
|
||||||
- **Sub/Dub** support per provider
|
- **Sub/Dub** support per provider
|
||||||
- **Codec and fansub** metadata
|
- **Codec and fansub** metadata
|
||||||
|
- **Batch episode fetching** — multiple sources in parallel
|
||||||
|
- **Quality fallback** — auto 1080p → 720p → 360p
|
||||||
|
- **Subtitle extraction** — expose subtitle URLs
|
||||||
|
|
||||||
</td>
|
</td>
|
||||||
<td>
|
<td>
|
||||||
@@ -186,7 +195,7 @@ flowchart TD
|
|||||||
|
|
||||||
| Feature | Description | Status |
|
| Feature | Description | Status |
|
||||||
|:---|:---|:---:|
|
|:---|:---|:---:|
|
||||||
| 🎬 18 API Endpoints | Complete anime data coverage | ✅ |
|
| 🎬 35 API Endpoints | Complete anime data coverage | ✅ |
|
||||||
| 🔍 Full-Text Search | Keyword search with pagination | ✅ |
|
| 🔍 Full-Text Search | Keyword search with pagination | ✅ |
|
||||||
| 💡 Search Suggestions | Fast autocomplete | ✅ |
|
| 💡 Search Suggestions | Fast autocomplete | ✅ |
|
||||||
| 🎯 Advanced Filtering | Genre, year, season, format, sort | ✅ |
|
| 🎯 Advanced Filtering | Genre, year, season, format, sort | ✅ |
|
||||||
@@ -318,7 +327,7 @@ MiruroAPI/
|
|||||||
│ │ └── 📄 cache.js # 💾 In-memory cache with TTL
|
│ │ └── 📄 cache.js # 💾 In-memory cache with TTL
|
||||||
│ │
|
│ │
|
||||||
│ └── 📂 routes/ # 🛤️ Express routes
|
│ └── 📂 routes/ # 🛤️ Express routes
|
||||||
│ └── 📄 apiRoutes.js # 🌐 Main API routes (18 endpoints)
|
│ └── 📄 apiRoutes.js # 🌐 Main API routes (35 endpoints)
|
||||||
│
|
│
|
||||||
├── 📄 server.js # 🚀 Express server entry point
|
├── 📄 server.js # 🚀 Express server entry point
|
||||||
├── 📄 package.json # 📦 Dependencies & scripts
|
├── 📄 package.json # 📦 Dependencies & scripts
|
||||||
@@ -481,13 +490,13 @@ console.log(resp.data);
|
|||||||
"success": true,
|
"success": true,
|
||||||
"results": {
|
"results": {
|
||||||
"status": "healthy",
|
"status": "healthy",
|
||||||
"version": "1.2.0",
|
"version": "2.0.0",
|
||||||
"uptime": "0h 0m 34s",
|
"uptime": "0h 0m 34s",
|
||||||
"uptimeSeconds": 34,
|
"uptimeSeconds": 34,
|
||||||
"timestamp": "2026-06-09T09:55:00.884Z",
|
"timestamp": "2026-06-09T09:55:00.884Z",
|
||||||
"node": "v24.14.1",
|
"node": "v24.14.1",
|
||||||
"memory": { "used": "13MB", "total": "15MB" },
|
"memory": { "used": "13MB", "total": "15MB" },
|
||||||
"endpoints": 16,
|
"endpoints": 35,
|
||||||
"providers": ["kiwi","pewe","bee","bonk","bun","ally","nun","twin","cog","moo","hop","telli"]
|
"providers": ["kiwi","pewe","bee","bonk","bun","ally","nun","twin","cog","moo","hop","telli"]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -528,7 +537,7 @@ console.log(resp.data);
|
|||||||
"uptime": "0h 0m 34s",
|
"uptime": "0h 0m 34s",
|
||||||
"requests": { "total": 156, "errors": 3, "successRate": "98.1%" },
|
"requests": { "total": 156, "errors": 3, "successRate": "98.1%" },
|
||||||
"cache": { "size": 12, "maxSize": 100, "ttl": "1 min" },
|
"cache": { "size": 12, "maxSize": 100, "ttl": "1 min" },
|
||||||
"endpoints": 16,
|
"endpoints": 35,
|
||||||
"timestamp": "2026-06-09T09:55:00.884Z"
|
"timestamp": "2026-06-09T09:55:00.884Z"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1399,6 +1408,9 @@ docker run -p 3000:3000 miruroapi
|
|||||||
|
|
||||||
| Version | Date | Key Changes |
|
| Version | Date | Key Changes |
|
||||||
|:---|:---|:---|
|
|:---|:---|:---|
|
||||||
|
| **2.0.0** | 2026-06-25 | Major upgrade — 35 endpoints, compression, streaming improvements, new features |
|
||||||
|
| **1.4.0** | 2026-06-25 | Creator attribution middleware, Vercel deployment fix, security headers |
|
||||||
|
| **1.3.0** | 2026-06-25 | Full landing page upgrade with premium design |
|
||||||
| **1.2.0** | 2026-06-09 | Critical response format fix, full endpoint diagnostic, 18/18 passing |
|
| **1.2.0** | 2026-06-09 | Critical response format fix, full endpoint diagnostic, 18/18 passing |
|
||||||
| **1.1.0** | 2026-06-09 | Swagger UI docs, OpenAPI spec, mappings field, Docker, landing page |
|
| **1.1.0** | 2026-06-09 | Swagger UI docs, OpenAPI spec, mappings field, Docker, landing page |
|
||||||
| **1.0.0** | 2026-06-09 | Initial release — 16 endpoints, AniList GraphQL + Miruro pipe, caching |
|
| **1.0.0** | 2026-06-09 | Initial release — 16 endpoints, AniList GraphQL + Miruro pipe, caching |
|
||||||
@@ -1494,7 +1506,7 @@ Yes! Use <code>npm start</code> to run the Express server on any VPS, Docker con
|
|||||||
|
|
||||||
### ✅ Completed
|
### ✅ Completed
|
||||||
|
|
||||||
- [x] 🎬 18 API endpoints covering all data
|
- [x] 🎬 35 API endpoints covering all data
|
||||||
- [x] 🔍 Full-text search with pagination
|
- [x] 🔍 Full-text search with pagination
|
||||||
- [x] 💡 Search suggestions for autocomplete
|
- [x] 💡 Search suggestions for autocomplete
|
||||||
- [x] 🎯 Advanced filtering (genre, year, season, format, sort)
|
- [x] 🎯 Advanced filtering (genre, year, season, format, sort)
|
||||||
@@ -1576,8 +1588,8 @@ git push origin feature/amazing-feature
|
|||||||
- ✅ Update CHANGELOG.md with your changes
|
- ✅ Update CHANGELOG.md with your changes
|
||||||
- ✅ Keep PRs focused — one feature or fix per PR
|
- ✅ Keep PRs focused — one feature or fix per PR
|
||||||
- ✅ Add JSDoc comments for new functions
|
- ✅ Add JSDoc comments for new functions
|
||||||
- ❌ Don't commit `node_modules` or cache files
|
- ❎ Don't commit `node_modules` or cache files
|
||||||
- ❌ Don't add unrelated changes to a single PR
|
- ❎ Don't add unrelated changes to a single PR
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -1657,8 +1669,10 @@ Free to use, modify, and distribute — see the [LICENSE](LICENSE) file for deta
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
<p align="center">
|
<div align="center">
|
||||||
<b>Made With ❤️ For The Anime Community</b>
|
<p align="center">
|
||||||
<br/><br/>
|
<b>Made With ❤️ For The Anime Community</b>
|
||||||
<sub>© 2026 Shineii86. All Rights Reserved.</sub>
|
<br/><br/>
|
||||||
</p>
|
<sub>© Shinei Nouzen. All Rights Reserved.</sub>
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|||||||
@@ -0,0 +1 @@
|
|||||||
|
module.exports = require("../server");
|
||||||
+539
-311
@@ -1,29 +1,553 @@
|
|||||||
# API Endpoints Reference
|
# API Endpoints Reference
|
||||||
|
|
||||||
Complete documentation for all 18 MiruroAPI endpoints.
|
Complete documentation for all 35 MiruroAPI v2.0.0 endpoints.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Table of Contents
|
## Table of Contents
|
||||||
|
|
||||||
- [Health Check](#health-check)
|
### Search & Discovery
|
||||||
- [Stats](#stats)
|
|
||||||
- [Search](#search)
|
- [Search](#search)
|
||||||
- [Suggestions](#suggestions)
|
- [Suggestions](#suggestions)
|
||||||
- [Filter](#filter)
|
- [Filter](#filter)
|
||||||
|
- [Multi-Search](#multi-search)
|
||||||
|
|
||||||
|
### Collections
|
||||||
- [Trending](#trending)
|
- [Trending](#trending)
|
||||||
|
- [Trending Daily](#trending-daily)
|
||||||
|
- [Trending Weekly](#trending-weekly)
|
||||||
- [Popular](#popular)
|
- [Popular](#popular)
|
||||||
|
- [Top](#top)
|
||||||
- [Upcoming](#upcoming)
|
- [Upcoming](#upcoming)
|
||||||
- [Recent](#recent)
|
- [Recent](#recent)
|
||||||
- [Spotlight](#spotlight)
|
- [Spotlight](#spotlight)
|
||||||
- [Schedule](#schedule)
|
- [Schedule](#schedule)
|
||||||
|
- [Random](#random)
|
||||||
|
- [Upcoming Countdown](#upcoming-countdown)
|
||||||
|
|
||||||
|
### Seasonal & Studio
|
||||||
|
- [Seasonal Anime](#seasonal-anime)
|
||||||
|
- [Anime by Studio](#anime-by-studio)
|
||||||
|
|
||||||
|
### Genres & Tags
|
||||||
|
- [Genres](#genres)
|
||||||
|
- [Tags](#tags)
|
||||||
|
- [Anime by Genre](#anime-by-genre)
|
||||||
|
- [Anime by Year](#anime-by-year)
|
||||||
|
- [Anime by Status](#anime-by-status)
|
||||||
|
- [Anime by Format](#anime-by-format)
|
||||||
|
|
||||||
|
### Character & Staff
|
||||||
|
- [Character Detail](#character-detail)
|
||||||
|
- [Staff Detail](#staff-detail)
|
||||||
|
- [Search Characters](#search-characters)
|
||||||
|
- [Search Staff](#search-staff)
|
||||||
|
|
||||||
|
### Anime Details
|
||||||
- [Anime Info](#anime-info)
|
- [Anime Info](#anime-info)
|
||||||
- [Characters](#characters)
|
- [Characters](#characters)
|
||||||
- [Relations](#relations)
|
- [Relations](#relations)
|
||||||
- [Recommendations](#recommendations)
|
- [Recommendations](#recommendations)
|
||||||
|
|
||||||
|
### Streaming & Downloading
|
||||||
- [Episodes](#episodes)
|
- [Episodes](#episodes)
|
||||||
|
- [Batch Episodes](#batch-episodes)
|
||||||
|
- [Sources (Detailed)](#sources-detailed)
|
||||||
|
- [Stream (Quality Fallback)](#stream-quality-fallback)
|
||||||
|
- [Download URL](#download-url)
|
||||||
- [Watch (Streaming)](#watch-streaming)
|
- [Watch (Streaming)](#watch-streaming)
|
||||||
|
|
||||||
|
### Utility
|
||||||
|
- [Compare](#compare)
|
||||||
|
- [Genre Stats](#genre-stats)
|
||||||
|
- [Calendar](#calendar)
|
||||||
|
- [Timeline](#timeline)
|
||||||
|
|
||||||
|
### System
|
||||||
|
- [Health Check](#health-check)
|
||||||
|
- [Stats](#stats)
|
||||||
|
- [OpenAPI](#openapi)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Search
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/search?query=naruto
|
||||||
|
```
|
||||||
|
|
||||||
|
Full-text anime search with pagination.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| query | string | required | Search query |
|
||||||
|
| page | int | 1 | Page number |
|
||||||
|
| per_page | int | 20 | Results per page (max 50) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Suggestions
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/suggestions?query=naruto
|
||||||
|
```
|
||||||
|
|
||||||
|
Lightweight autocomplete suggestions (max 8 results).
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| query | string | required | Search query |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Filter
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/filter?genre=Action&year=2024&season=SPRING
|
||||||
|
```
|
||||||
|
|
||||||
|
Advanced anime filter with multiple parameters.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| genre | string | — | Genre name |
|
||||||
|
| tag | string | — | Tag name |
|
||||||
|
| year | int | — | Season year |
|
||||||
|
| season | string | — | WINTER, SPRING, SUMMER, FALL |
|
||||||
|
| format | string | — | TV, MOVIE, OVA, ONA, SPECIAL |
|
||||||
|
| status | string | — | RELEASING, FINISHED, NOT_YET_RELEASED |
|
||||||
|
| sort | string | POPULARITY_DESC | Sort order |
|
||||||
|
| page | int | 1 | Page number |
|
||||||
|
| per_page | int | 20 | Results per page |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Multi-Search
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/multi-search?q=naruto&genre=Action&year=2024
|
||||||
|
```
|
||||||
|
|
||||||
|
Combined query + filters search.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Trending
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/trending?page=1&per_page=20
|
||||||
|
```
|
||||||
|
|
||||||
|
Currently trending anime.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Trending Daily
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/trending/daily
|
||||||
|
```
|
||||||
|
|
||||||
|
Trending anime from the last 7 days.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Trending Weekly
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/trending/weekly
|
||||||
|
```
|
||||||
|
|
||||||
|
Trending anime from the last 30 days.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Popular
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/popular
|
||||||
|
```
|
||||||
|
|
||||||
|
Most popular anime of all time.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Top
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/top
|
||||||
|
```
|
||||||
|
|
||||||
|
Top anime by score (all time).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Upcoming
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/upcoming
|
||||||
|
```
|
||||||
|
|
||||||
|
Most anticipated upcoming anime.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Recent
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/recent
|
||||||
|
```
|
||||||
|
|
||||||
|
Currently airing anime.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Spotlight
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/spotlight
|
||||||
|
```
|
||||||
|
|
||||||
|
Top 10 trending + popular anime for hero banners.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Schedule
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/schedule?page=1&per_page=20
|
||||||
|
```
|
||||||
|
|
||||||
|
Airing schedule with timestamps.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Random
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/random
|
||||||
|
```
|
||||||
|
|
||||||
|
Returns a random anime.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Upcoming Countdown
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/upcoming/countdown
|
||||||
|
```
|
||||||
|
|
||||||
|
Next 10 episodes airing soon.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Seasonal Anime
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/season/2025/spring
|
||||||
|
```
|
||||||
|
|
||||||
|
Anime for a specific year and season.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| year | int | required | Year (e.g., 2025) |
|
||||||
|
| season | string | required | WINTER, SPRING, SUMMER, FALL |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anime by Studio
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/studio/MAPPA
|
||||||
|
```
|
||||||
|
|
||||||
|
All anime produced by a specific studio.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| name | string | required | Studio name |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Genres
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/genres
|
||||||
|
```
|
||||||
|
|
||||||
|
Returns all available genres from AniList.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tags
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/tags
|
||||||
|
```
|
||||||
|
|
||||||
|
Returns all available tags from AniList.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anime by Genre
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/genre/Action
|
||||||
|
```
|
||||||
|
|
||||||
|
All anime in a specific genre.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anime by Year
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/year/2024
|
||||||
|
```
|
||||||
|
|
||||||
|
All anime from a specific year.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anime by Status
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/status/RELEASING
|
||||||
|
```
|
||||||
|
|
||||||
|
All anime with a specific status (RELEASING, FINISHED, NOT_YET_RELEASED).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anime by Format
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/format/MOVIE
|
||||||
|
```
|
||||||
|
|
||||||
|
All anime with a specific format (TV, MOVIE, OVA, ONA, SPECIAL).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Character Detail
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/character/1
|
||||||
|
```
|
||||||
|
|
||||||
|
Detailed character info with anime list.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| id | int | required | AniList character ID |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Staff Detail
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/staff/1
|
||||||
|
```
|
||||||
|
|
||||||
|
Detailed staff info with anime list.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| id | int | required | AniList staff ID |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Search Characters
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/characters?query=kaneki
|
||||||
|
```
|
||||||
|
|
||||||
|
Search characters by name.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Search Staff
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/staff?query=oda
|
||||||
|
```
|
||||||
|
|
||||||
|
Search staff by name.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anime Info
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/info/20605
|
||||||
|
```
|
||||||
|
|
||||||
|
Complete anime info including characters, relations, recommendations, trailer, stats.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Characters
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/anime/20605/characters?page=1&per_page=25
|
||||||
|
```
|
||||||
|
|
||||||
|
Paginated character list with voice actors.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Relations
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/anime/20605/relations
|
||||||
|
```
|
||||||
|
|
||||||
|
Related anime (sequels, prequels, spin-offs).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Recommendations
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/anime/20605/recommendations?page=1&per_page=10
|
||||||
|
```
|
||||||
|
|
||||||
|
Community recommendations sorted by rating.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Episodes
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/episodes/20605
|
||||||
|
```
|
||||||
|
|
||||||
|
Episode list from all providers with sub/dub support.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Batch Episodes
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/episodes/20605/batch?provider=kiwi&category=sub&slugs=animepahe-1,animepahe-2
|
||||||
|
```
|
||||||
|
|
||||||
|
Fetch multiple episode sources in parallel.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| provider | string | kiwi | Provider name |
|
||||||
|
| category | string | sub | sub or dub |
|
||||||
|
| slugs | string | required | Comma-separated episode slugs |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Sources (Detailed)
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/sources?episodeId=xxx&provider=kiwi&anilistId=20605&category=sub
|
||||||
|
```
|
||||||
|
|
||||||
|
Streaming sources with raw episode ID.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Stream (Quality Fallback)
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/stream?provider=kiwi&anilistId=20605&category=sub&slug=animepahe-1&quality=1080p
|
||||||
|
```
|
||||||
|
|
||||||
|
Streaming sources with automatic quality fallback.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| provider | string | required | Provider name |
|
||||||
|
| anilistId | int | required | AniList anime ID |
|
||||||
|
| category | string | sub | sub or dub |
|
||||||
|
| slug | string | required | Episode slug |
|
||||||
|
| quality | string | 1080p | Preferred quality |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Download URL
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/download?provider=kiwi&anilistId=20605&category=sub&slug=animepahe-1
|
||||||
|
```
|
||||||
|
|
||||||
|
Returns the download URL for an episode.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Watch (Streaming)
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/watch/kiwi/20605/sub/animepahe-1
|
||||||
|
```
|
||||||
|
|
||||||
|
Streaming sources via URL path (recommended).
|
||||||
|
|
||||||
|
| Param | Type | Description |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| provider | string | Provider name |
|
||||||
|
| anilistId | int | AniList anime ID |
|
||||||
|
| category | string | sub or dub |
|
||||||
|
| slug | string | Episode slug |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Compare
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/compare/20605/20
|
||||||
|
```
|
||||||
|
|
||||||
|
Compare two anime side by side.
|
||||||
|
|
||||||
|
| Param | Type | Description |
|
||||||
|
|-------|------|-------------|
|
||||||
|
| id1 | int | First anime ID |
|
||||||
|
| id2 | int | Second anime ID |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Genre Stats
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/stats/genre
|
||||||
|
```
|
||||||
|
|
||||||
|
Genre statistics with top anime per genre.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Calendar
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/calendar?year=2025&month=6
|
||||||
|
```
|
||||||
|
|
||||||
|
Monthly airing calendar.
|
||||||
|
|
||||||
|
| Param | Type | Default | Description |
|
||||||
|
|-------|------|---------|-------------|
|
||||||
|
| year | int | current | Year |
|
||||||
|
| month | int | current | Month (1-12) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Timeline
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /api/timeline/20605
|
||||||
|
```
|
||||||
|
|
||||||
|
Anime release timeline with prequels, sequels, spin-offs.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Health Check
|
## Health Check
|
||||||
@@ -32,7 +556,7 @@ Complete documentation for all 18 MiruroAPI endpoints.
|
|||||||
GET /api/health
|
GET /api/health
|
||||||
```
|
```
|
||||||
|
|
||||||
Returns API health status, version, uptime, memory usage, and available providers.
|
API health status, version, uptime, memory, cache stats.
|
||||||
|
|
||||||
**Response:**
|
**Response:**
|
||||||
|
|
||||||
@@ -41,11 +565,12 @@ Returns API health status, version, uptime, memory usage, and available provider
|
|||||||
"success": true,
|
"success": true,
|
||||||
"results": {
|
"results": {
|
||||||
"status": "healthy",
|
"status": "healthy",
|
||||||
"version": "1.2.0",
|
"version": "2.0.0",
|
||||||
"uptime": "0h 0m 34s",
|
"uptime": "0h 0m 34s",
|
||||||
"node": "v24.14.1",
|
"node": "v24.14.1",
|
||||||
"memory": { "used": "13MB", "total": "15MB" },
|
"memory": { "used": "13MB", "total": "15MB", "rss": "25MB" },
|
||||||
"endpoints": 16,
|
"cache": { "size": 12, "maxSize": 100 },
|
||||||
|
"endpoints": 35,
|
||||||
"providers": ["kiwi","pewe","bee","bonk","bun","ally","nun","twin","cog","moo","hop","telli"]
|
"providers": ["kiwi","pewe","bee","bonk","bun","ally","nun","twin","cog","moo","hop","telli"]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -59,317 +584,20 @@ Returns API health status, version, uptime, memory usage, and available provider
|
|||||||
GET /api/stats
|
GET /api/stats
|
||||||
```
|
```
|
||||||
|
|
||||||
Returns request statistics, cache info, and memory usage.
|
Cache & API statistics including request count and success rate.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Search
|
## OpenAPI
|
||||||
|
|
||||||
```
|
```
|
||||||
GET /api/search
|
GET /api/openapi
|
||||||
```
|
```
|
||||||
|
|
||||||
| Param | Type | Required | Default | Description |
|
Returns the OpenAPI 3.0.3 specification in JSON format.
|
||||||
|-------|------|----------|---------|-------------|
|
|
||||||
| `query` | string | Yes | — | Search keyword |
|
|
||||||
| `page` | number | No | 1 | Page number |
|
|
||||||
| `per_page` | number | No | 20 | Results per page |
|
|
||||||
|
|
||||||
**Example:** `GET /api/search?query=naruto&per_page=2`
|
|
||||||
|
|
||||||
**Response:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"success": true,
|
|
||||||
"results": {
|
|
||||||
"page": 1,
|
|
||||||
"perPage": 2,
|
|
||||||
"total": 5000,
|
|
||||||
"hasNextPage": true,
|
|
||||||
"results": [
|
|
||||||
{
|
|
||||||
"id": 20,
|
|
||||||
"title": { "romaji": "NARUTO", "english": "Naruto", "native": "NARUTO -ナルト-" },
|
|
||||||
"coverImage": { "large": "https://s4.anilist.co/file/..." },
|
|
||||||
"format": "TV",
|
|
||||||
"episodes": 220,
|
|
||||||
"status": "FINISHED",
|
|
||||||
"averageScore": 80,
|
|
||||||
"genres": ["Action","Adventure","Comedy","Drama","Fantasy","Supernatural"]
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Suggestions
|
> 📝 All endpoints return `{ "success": true, "results": {...} }` on success and `{ "success": false, "message": "..." }` on error.
|
||||||
|
>
|
||||||
```
|
> 🎬 Creator attribution is injected into every response: `{ "creator": "Shinei Nouzen", "github": "...", "telegram": "...", "message": "...", "timestamp": "..." }`
|
||||||
GET /api/suggestions
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Description |
|
|
||||||
|-------|------|----------|-------------|
|
|
||||||
| `query` | string | Yes | Search keyword |
|
|
||||||
|
|
||||||
**Example:** `GET /api/suggestions?query=naruto`
|
|
||||||
|
|
||||||
Returns fast autocomplete suggestions with title, poster, format, status, year, and episode count.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Filter
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/filter
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Default | Description |
|
|
||||||
|-------|------|----------|---------|-------------|
|
|
||||||
| `genre` | string | No | — | Genre name (e.g. "Action") |
|
|
||||||
| `tag` | string | No | — | Tag name |
|
|
||||||
| `year` | number | No | — | Release year |
|
|
||||||
| `season` | string | No | — | FALL, WINTER, SPRING, SUMMER |
|
|
||||||
| `format` | string | No | — | TV, MOVIE, OVA, ONA, SPECIAL, MUSIC |
|
|
||||||
| `status` | string | No | — | RELEASING, FINISHED, NOT_YET_RELEASED, CANCELLED |
|
|
||||||
| `sort` | string | No | POPULARITY_DESC | Sort order |
|
|
||||||
| `page` | number | No | 1 | Page number |
|
|
||||||
| `per_page` | number | No | 20 | Results per page |
|
|
||||||
|
|
||||||
**Example:** `GET /api/filter?genre=Action&year=2024&season=WINTER&per_page=3`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Trending
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/trending
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Default | Description |
|
|
||||||
|-------|------|----------|---------|-------------|
|
|
||||||
| `per_page` | number | No | 20 | Results per page |
|
|
||||||
|
|
||||||
**Example:** `GET /api/trending?per_page=5`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Popular
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/popular
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Default | Description |
|
|
||||||
|-------|------|----------|---------|-------------|
|
|
||||||
| `per_page` | number | No | 20 | Results per page |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Upcoming
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/upcoming
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Default | Description |
|
|
||||||
|-------|------|----------|---------|-------------|
|
|
||||||
| `per_page` | number | No | 20 | Results per page |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Recent
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/recent
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Default | Description |
|
|
||||||
|-------|------|----------|---------|-------------|
|
|
||||||
| `per_page` | number | No | 20 | Results per page |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Spotlight
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/spotlight
|
|
||||||
```
|
|
||||||
|
|
||||||
Returns featured/spotlight anime for the hero carousel.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Schedule
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/schedule
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Default | Description |
|
|
||||||
|-------|------|----------|---------|-------------|
|
|
||||||
| `date` | string | No | today | Date in YYYY-MM-DD format |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Anime Info
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/info/:id
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Description |
|
|
||||||
|-------|------|----------|-------------|
|
|
||||||
| `id` | number | Yes | AniList anime ID |
|
|
||||||
|
|
||||||
**Example:** `GET /api/info/20`
|
|
||||||
|
|
||||||
**Response:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"success": true,
|
|
||||||
"results": {
|
|
||||||
"id": 20,
|
|
||||||
"idMal": 20,
|
|
||||||
"title": { "romaji": "NARUTO", "english": "Naruto", "native": "NARUTO -ナルト-" },
|
|
||||||
"description": "Naruto Uzumaki, a hyperactive and knuckle-headed ninja...",
|
|
||||||
"coverImage": { "large": "https://s4.anilist.co/file/..." },
|
|
||||||
"format": "TV",
|
|
||||||
"episodes": 220,
|
|
||||||
"duration": 23,
|
|
||||||
"status": "FINISHED",
|
|
||||||
"averageScore": 80,
|
|
||||||
"genres": ["Action","Adventure","Comedy","Drama","Fantasy","Supernatural"],
|
|
||||||
"studios": [{ "name": "Studio Pierrot", "isAnimationStudio": true }]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Characters
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/anime/:id/characters
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Description |
|
|
||||||
|-------|------|----------|-------------|
|
|
||||||
| `id` | number | Yes | AniList anime ID |
|
|
||||||
|
|
||||||
**Example:** `GET /api/anime/20/characters`
|
|
||||||
|
|
||||||
Returns characters with voice actors.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Relations
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/anime/:id/relations
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Description |
|
|
||||||
|-------|------|----------|-------------|
|
|
||||||
| `id` | number | Yes | AniList anime ID |
|
|
||||||
|
|
||||||
Returns related anime (sequels, prequels, side stories, etc.).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Recommendations
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/anime/:id/recommendations
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Description |
|
|
||||||
|-------|------|----------|-------------|
|
|
||||||
| `id` | number | Yes | AniList anime ID |
|
|
||||||
|
|
||||||
Returns recommended anime based on the given ID.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Episodes
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/episodes/:id
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Description |
|
|
||||||
|-------|------|----------|-------------|
|
|
||||||
| `id` | number | Yes | AniList anime ID |
|
|
||||||
|
|
||||||
**Example:** `GET /api/episodes/20`
|
|
||||||
|
|
||||||
**Response:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"success": true,
|
|
||||||
"results": {
|
|
||||||
"providers": {
|
|
||||||
"kiwi": {
|
|
||||||
"meta": { "id": "1571", "title": "Naruto", "type": "TV" },
|
|
||||||
"episodes": {
|
|
||||||
"sub": [
|
|
||||||
{
|
|
||||||
"id": "watch/kiwi/20/sub/animepahe-1",
|
|
||||||
"number": 1,
|
|
||||||
"title": "Enter: Naruto Uzumaki!",
|
|
||||||
"airDate": "2002-10-03",
|
|
||||||
"audio": "sub",
|
|
||||||
"filler": false
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Watch (Streaming)
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/watch/:provider/:anilistId/:category/:slug
|
|
||||||
```
|
|
||||||
|
|
||||||
| Param | Type | Required | Description |
|
|
||||||
|-------|------|----------|-------------|
|
|
||||||
| `provider` | string | Yes | Provider name (kiwi, pewe, etc.) |
|
|
||||||
| `anilistId` | number | Yes | AniList anime ID |
|
|
||||||
| `category` | string | Yes | sub or dub |
|
|
||||||
| `slug` | string | Yes | Episode slug from episodes response |
|
|
||||||
|
|
||||||
**Example:** `GET /api/watch/kiwi/20/sub/animepahe-1`
|
|
||||||
|
|
||||||
**Response:**
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"success": true,
|
|
||||||
"results": {
|
|
||||||
"streams": [
|
|
||||||
{
|
|
||||||
"url": "https://vault-01.uwucdn.top/stream/.../uwu.m3u8",
|
|
||||||
"type": "hls",
|
|
||||||
"quality": "360p",
|
|
||||||
"resolution": { "width": 640, "height": 360 },
|
|
||||||
"codec": "h264",
|
|
||||||
"audio": "sub",
|
|
||||||
"fansub": "df68",
|
|
||||||
"referer": "https://kwik.cx/e/..."
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"download": "https://pahe.win/LJmbA"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|||||||
Generated
+1480
File diff suppressed because it is too large
Load Diff
+4
-3
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "miruro-api",
|
"name": "miruro-api",
|
||||||
"version": "1.3.0",
|
"version": "2.0.0",
|
||||||
"description": "RESTful API for miruro.tv - Anime streaming data powered by AniList GraphQL and Miruro streaming providers",
|
"description": "RESTful API for miruro.tv - Anime streaming data powered by AniList GraphQL and Miruro streaming providers",
|
||||||
"main": "server.js",
|
"main": "server.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
@@ -9,10 +9,11 @@
|
|||||||
"test": "node test.js"
|
"test": "node test.js"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"express": "^4.21.0",
|
|
||||||
"axios": "^1.8.0",
|
"axios": "^1.8.0",
|
||||||
|
"compression": "^1.8.1",
|
||||||
"cors": "^2.8.5",
|
"cors": "^2.8.5",
|
||||||
"dotenv": "^16.4.0"
|
"dotenv": "^16.4.0",
|
||||||
|
"express": "^4.21.0"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"nodemon": "^3.1.0"
|
"nodemon": "^3.1.0"
|
||||||
|
|||||||
+6
-6
@@ -10,7 +10,7 @@
|
|||||||
<meta property="og:type" content="website" />
|
<meta property="og:type" content="website" />
|
||||||
<meta property="og:url" content="https://mirurotvapi.vercel.app" />
|
<meta property="og:url" content="https://mirurotvapi.vercel.app" />
|
||||||
<meta property="og:image" content="https://mirurotvapi.vercel.app/og-image.png" />
|
<meta property="og:image" content="https://mirurotvapi.vercel.app/og-image.png" />
|
||||||
<meta property="og:description" content="Free RESTful API for anime streaming data. 18 endpoints, 12 providers, M3U8 streaming URLs. Powered by AniList GraphQL and Miruro." />
|
<meta property="og:description" content="Free RESTful API for anime streaming data. 35 endpoints, 12 providers, M3U8 streaming URLs. Powered by AniList GraphQL and Miruro." />
|
||||||
<meta property="og:site_name" content="MiruroAPI" />
|
<meta property="og:site_name" content="MiruroAPI" />
|
||||||
<meta property="og:locale" content="en_US" />
|
<meta property="og:locale" content="en_US" />
|
||||||
|
|
||||||
@@ -26,13 +26,13 @@
|
|||||||
<meta name="twitter:site" content="@Shineii86" />
|
<meta name="twitter:site" content="@Shineii86" />
|
||||||
<meta name="twitter:creator" content="@Shineii86" />
|
<meta name="twitter:creator" content="@Shineii86" />
|
||||||
<meta name="twitter:title" content="MiruroAPI — Free Anime Streaming API" />
|
<meta name="twitter:title" content="MiruroAPI — Free Anime Streaming API" />
|
||||||
<meta name="twitter:description" content="Free RESTful API for anime streaming data. 18 endpoints, 12 providers, M3U8 streaming URLs." />
|
<meta name="twitter:description" content="Free RESTful API for anime streaming data. 35 endpoints, 12 providers, M3U8 streaming URLs." />
|
||||||
<meta name="twitter:image" content="https://mirurotvapi.vercel.app/og-image.png" />
|
<meta name="twitter:image" content="https://mirurotvapi.vercel.app/og-image.png" />
|
||||||
<meta name="twitter:image:alt" content="MiruroAPI - Free Anime Streaming API" />
|
<meta name="twitter:image:alt" content="MiruroAPI - Free Anime Streaming API" />
|
||||||
<meta name="twitter:domain" content="mirurotvapi.vercel.app" />
|
<meta name="twitter:domain" content="mirurotvapi.vercel.app" />
|
||||||
|
|
||||||
<!-- ──────────────── Generic Meta ──────────────── -->
|
<!-- ──────────────── Generic Meta ──────────────── -->
|
||||||
<meta name="description" content="Free RESTful API for anime streaming data. 18 endpoints, 12 providers, M3U8 streaming URLs. Powered by AniList GraphQL and Miruro." />
|
<meta name="description" content="Free RESTful API for anime streaming data. 35 endpoints, 12 providers, M3U8 streaming URLs. Powered by AniList GraphQL and Miruro." />
|
||||||
<meta name="author" content="Shinei Nouzen" />
|
<meta name="author" content="Shinei Nouzen" />
|
||||||
<meta name="keywords" content="anime api, free api, rest api, anime streaming, m3u8, anime data, anilist, miruro, episode streaming, sub, dub" />
|
<meta name="keywords" content="anime api, free api, rest api, anime streaming, m3u8, anime data, anilist, miruro, episode streaming, sub, dub" />
|
||||||
<meta name="robots" content="index, follow" />
|
<meta name="robots" content="index, follow" />
|
||||||
@@ -278,7 +278,7 @@
|
|||||||
"@context": "https://schema.org",
|
"@context": "https://schema.org",
|
||||||
"@type": "WebAPI",
|
"@type": "WebAPI",
|
||||||
"name": "MiruroAPI",
|
"name": "MiruroAPI",
|
||||||
"description": "Free RESTful API for anime streaming data. 18 endpoints, 12 providers, M3U8 streaming URLs.",
|
"description": "Free RESTful API for anime streaming data. 35 endpoints, 12 providers, M3U8 streaming URLs.",
|
||||||
"url": "https://mirurotvapi.vercel.app",
|
"url": "https://mirurotvapi.vercel.app",
|
||||||
"image": "https://mirurotvapi.vercel.app/og-image.png",
|
"image": "https://mirurotvapi.vercel.app/og-image.png",
|
||||||
"documentation": "https://mirurotvapi.vercel.app/docs",
|
"documentation": "https://mirurotvapi.vercel.app/docs",
|
||||||
@@ -326,7 +326,7 @@
|
|||||||
<section class="hero container">
|
<section class="hero container">
|
||||||
<div class="hero-badge"><span class="dot"></span> Free · No API key · Open source</div>
|
<div class="hero-badge"><span class="dot"></span> Free · No API key · Open source</div>
|
||||||
<h1>The <span class="grad">Anime Streaming</span> API<br/>for Your Next Project</h1>
|
<h1>The <span class="grad">Anime Streaming</span> API<br/>for Your Next Project</h1>
|
||||||
<p class="hero-sub">Search, discover, and stream anime with M3U8 URLs. Powered by AniList GraphQL + Miruro providers. 18 endpoints, 12 providers, zero config.</p>
|
<p class="hero-sub">Search, discover, and stream anime with M3U8 URLs. Powered by AniList GraphQL + Miruro providers. 35 endpoints, 12 providers, zero config.</p>
|
||||||
<div class="hero-actions">
|
<div class="hero-actions">
|
||||||
<a href="#playground" class="btn btn-primary">
|
<a href="#playground" class="btn btn-primary">
|
||||||
<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="5 3 19 12 5 21 5 3"/></svg>
|
<svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="5 3 19 12 5 21 5 3"/></svg>
|
||||||
@@ -370,7 +370,7 @@ fetch("https://mirurotvapi.vercel.app/api/search?query=naruto")
|
|||||||
<section class="stats">
|
<section class="stats">
|
||||||
<div class="container">
|
<div class="container">
|
||||||
<div class="stats-grid">
|
<div class="stats-grid">
|
||||||
<div class="reveal"><div class="stat-value grad" data-count="18">0</div><div class="stat-label">API Endpoints</div></div>
|
<div class="reveal"><div class="stat-value grad" data-count="35">0</div><div class="stat-label">API Endpoints</div></div>
|
||||||
<div class="reveal reveal-delay-1"><div class="stat-value grad" data-count="12">0</div><div class="stat-label">Streaming Providers</div></div>
|
<div class="reveal reveal-delay-1"><div class="stat-value grad" data-count="12">0</div><div class="stat-label">Streaming Providers</div></div>
|
||||||
<div class="reveal reveal-delay-2"><div class="stat-value grad" data-count="5000">0</div><div class="stat-label">Anime Indexed</div></div>
|
<div class="reveal reveal-delay-2"><div class="stat-value grad" data-count="5000">0</div><div class="stat-label">Anime Indexed</div></div>
|
||||||
<div class="reveal reveal-delay-3"><div class="stat-value grad">M3U8</div><div class="stat-label">Stream Format</div></div>
|
<div class="reveal reveal-delay-3"><div class="stat-value grad">M3U8</div><div class="stat-label">Stream Format</div></div>
|
||||||
|
|||||||
+280
-122
@@ -3,7 +3,7 @@
|
|||||||
"info": {
|
"info": {
|
||||||
"title": "MiruroAPI",
|
"title": "MiruroAPI",
|
||||||
"description": "Free RESTful API for anime streaming data. Powered by AniList GraphQL and Miruro streaming providers.",
|
"description": "Free RESTful API for anime streaming data. Powered by AniList GraphQL and Miruro streaming providers.",
|
||||||
"version": "1.1.0",
|
"version": "2.0.0",
|
||||||
"contact": {
|
"contact": {
|
||||||
"name": "Shineii86",
|
"name": "Shineii86",
|
||||||
"url": "https://github.com/Shineii86/MiruroAPI"
|
"url": "https://github.com/Shineii86/MiruroAPI"
|
||||||
@@ -18,230 +18,388 @@
|
|||||||
"description": "Production"
|
"description": "Production"
|
||||||
}
|
}
|
||||||
],
|
],
|
||||||
|
"tags": [
|
||||||
|
{ "name": "Search", "description": "Search, filter, suggestions" },
|
||||||
|
{ "name": "Collections", "description": "Trending, popular, top, schedule" },
|
||||||
|
{ "name": "Seasonal & Studio", "description": "Seasonal anime, studio filter" },
|
||||||
|
{ "name": "Genres & Tags", "description": "Genre, year, status, format filters" },
|
||||||
|
{ "name": "Character & Staff", "description": "Character/staff details and search" },
|
||||||
|
{ "name": "Anime Details", "description": "Info, characters, relations, recommendations" },
|
||||||
|
{ "name": "Streaming", "description": "Episodes, sources, stream, download" },
|
||||||
|
{ "name": "Utility", "description": "Compare, stats, calendar, timeline" },
|
||||||
|
{ "name": "System", "description": "Health, stats, OpenAPI" }
|
||||||
|
],
|
||||||
"paths": {
|
"paths": {
|
||||||
"/api/health": {
|
|
||||||
"get": {
|
|
||||||
"tags": ["System"],
|
|
||||||
"summary": "Health check",
|
|
||||||
"operationId": "health",
|
|
||||||
"responses": {
|
|
||||||
"200": {
|
|
||||||
"description": "API is healthy",
|
|
||||||
"content": { "application/json": { "schema": { "type": "object" } } }
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"/api/search": {
|
"/api/search": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Search & Discovery"],
|
"tags": ["Search"],
|
||||||
"summary": "Search anime by name",
|
"summary": "Search anime by name",
|
||||||
"operationId": "searchAnime",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "query", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search query" },
|
{ "name": "query", "in": "query", "required": true, "schema": { "type": "string" } },
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20, "maximum": 50 } }
|
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20, "maximum": 50 } }
|
||||||
],
|
]
|
||||||
"responses": {
|
|
||||||
"200": { "description": "Search results with pagination" }
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/suggestions": {
|
"/api/suggestions": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Search & Discovery"],
|
"tags": ["Search"],
|
||||||
"summary": "Autocomplete suggestions",
|
"summary": "Autocomplete suggestions",
|
||||||
"operationId": "getSuggestions",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "query", "in": "query", "required": true, "schema": { "type": "string" } }
|
{ "name": "query", "in": "query", "required": true, "schema": { "type": "string" } }
|
||||||
],
|
]
|
||||||
"responses": {
|
|
||||||
"200": { "description": "Lightweight suggestions (max 8)" }
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/filter": {
|
"/api/filter": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Search & Discovery"],
|
"tags": ["Search"],
|
||||||
"summary": "Advanced filter / browse",
|
"summary": "Advanced filter",
|
||||||
"operationId": "filterAnime",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "genre", "in": "query", "schema": { "type": "string" }, "description": "e.g. Action, Romance" },
|
{ "name": "genre", "in": "query", "schema": { "type": "string" } },
|
||||||
{ "name": "tag", "in": "query", "schema": { "type": "string" }, "description": "e.g. Isekai, Time Skip" },
|
{ "name": "tag", "in": "query", "schema": { "type": "string" } },
|
||||||
{ "name": "year", "in": "query", "schema": { "type": "integer" } },
|
{ "name": "year", "in": "query", "schema": { "type": "integer" } },
|
||||||
{ "name": "season", "in": "query", "schema": { "type": "string", "enum": ["WINTER", "SPRING", "SUMMER", "FALL"] } },
|
{ "name": "season", "in": "query", "schema": { "type": "string", "enum": ["WINTER", "SPRING", "SUMMER", "FALL"] } },
|
||||||
{ "name": "format", "in": "query", "schema": { "type": "string", "enum": ["TV", "MOVIE", "OVA", "ONA", "SPECIAL", "MUSIC"] } },
|
{ "name": "format", "in": "query", "schema": { "type": "string", "enum": ["TV", "MOVIE", "OVA", "ONA", "SPECIAL"] } },
|
||||||
{ "name": "status", "in": "query", "schema": { "type": "string", "enum": ["RELEASING", "FINISHED", "NOT_YET_RELEASED", "CANCELLED", "HIATUS"] } },
|
{ "name": "status", "in": "query", "schema": { "type": "string", "enum": ["RELEASING", "FINISHED", "NOT_YET_RELEASED"] } },
|
||||||
{ "name": "sort", "in": "query", "schema": { "type": "string", "enum": ["SCORE_DESC", "POPULARITY_DESC", "TRENDING_DESC", "START_DATE_DESC", "FAVOURITES_DESC", "UPDATED_AT_DESC"], "default": "POPULARITY_DESC" } },
|
{ "name": "sort", "in": "query", "schema": { "type": "string", "default": "POPULARITY_DESC" } },
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20, "maximum": 50 } }
|
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20 } }
|
||||||
],
|
]
|
||||||
"responses": {
|
}
|
||||||
"200": { "description": "Filtered results with pagination" }
|
},
|
||||||
}
|
"/api/multi-search": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Search"],
|
||||||
|
"summary": "Multi-parameter search"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/trending": {
|
"/api/trending": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Collections"],
|
"tags": ["Collections"],
|
||||||
"summary": "Trending anime",
|
"summary": "Trending anime"
|
||||||
"operationId": "getTrending",
|
}
|
||||||
"parameters": [
|
},
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
"/api/trending/daily": {
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20 } }
|
"get": {
|
||||||
],
|
"tags": ["Collections"],
|
||||||
"responses": { "200": { "description": "Trending anime list" } }
|
"summary": "Daily trending anime"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/trending/weekly": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Collections"],
|
||||||
|
"summary": "Weekly trending anime"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/popular": {
|
"/api/popular": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Collections"],
|
"tags": ["Collections"],
|
||||||
"summary": "Most popular anime",
|
"summary": "Most popular anime"
|
||||||
"operationId": "getPopular",
|
}
|
||||||
"parameters": [
|
},
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
"/api/top": {
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20 } }
|
"get": {
|
||||||
],
|
"tags": ["Collections"],
|
||||||
"responses": { "200": { "description": "Popular anime list" } }
|
"summary": "Top anime by score"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/upcoming": {
|
"/api/upcoming": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Collections"],
|
"tags": ["Collections"],
|
||||||
"summary": "Upcoming anime",
|
"summary": "Upcoming anime"
|
||||||
"operationId": "getUpcoming",
|
|
||||||
"parameters": [
|
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20 } }
|
|
||||||
],
|
|
||||||
"responses": { "200": { "description": "Upcoming anime list" } }
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/recent": {
|
"/api/recent": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Collections"],
|
"tags": ["Collections"],
|
||||||
"summary": "Recently updated anime",
|
"summary": "Recently aired anime"
|
||||||
"operationId": "getRecent",
|
|
||||||
"parameters": [
|
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20 } }
|
|
||||||
],
|
|
||||||
"responses": { "200": { "description": "Recent anime list" } }
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/spotlight": {
|
"/api/spotlight": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Collections"],
|
"tags": ["Collections"],
|
||||||
"summary": "Spotlight / featured anime",
|
"summary": "Spotlight/featured anime"
|
||||||
"operationId": "getSpotlight",
|
|
||||||
"responses": { "200": { "description": "Top 10 trending + popular" } }
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/schedule": {
|
"/api/schedule": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Collections"],
|
"tags": ["Collections"],
|
||||||
"summary": "Airing schedule",
|
"summary": "Airing schedule"
|
||||||
"operationId": "getSchedule",
|
}
|
||||||
|
},
|
||||||
|
"/api/random": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Collections"],
|
||||||
|
"summary": "Random anime"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/upcoming/countdown": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Collections"],
|
||||||
|
"summary": "Next 10 episodes airing soon"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/season/{year}/{season}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Seasonal & Studio"],
|
||||||
|
"summary": "Seasonal anime",
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
{ "name": "year", "in": "path", "required": true, "schema": { "type": "integer" } },
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 20 } }
|
{ "name": "season", "in": "path", "required": true, "schema": { "type": "string", "enum": ["WINTER", "SPRING", "SUMMER", "FALL"] } }
|
||||||
],
|
]
|
||||||
"responses": { "200": { "description": "Upcoming episodes with timestamps" } }
|
}
|
||||||
|
},
|
||||||
|
"/api/studio/{name}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Seasonal & Studio"],
|
||||||
|
"summary": "Anime by studio",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "name", "in": "path", "required": true, "schema": { "type": "string" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/genres": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Genres & Tags"],
|
||||||
|
"summary": "All genres"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/tags": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Genres & Tags"],
|
||||||
|
"summary": "All tags"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/genre/{name}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Genres & Tags"],
|
||||||
|
"summary": "Anime by genre",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "name", "in": "path", "required": true, "schema": { "type": "string" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/year/{year}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Genres & Tags"],
|
||||||
|
"summary": "Anime by year",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "year", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/status/{status}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Genres & Tags"],
|
||||||
|
"summary": "Anime by status",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "status", "in": "path", "required": true, "schema": { "type": "string", "enum": ["RELEASING", "FINISHED", "NOT_YET_RELEASED"] } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/format/{format}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Genres & Tags"],
|
||||||
|
"summary": "Anime by format",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "format", "in": "path", "required": true, "schema": { "type": "string", "enum": ["TV", "MOVIE", "OVA", "ONA", "SPECIAL"] } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/character/{id}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Character & Staff"],
|
||||||
|
"summary": "Character detail",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/staff/{id}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Character & Staff"],
|
||||||
|
"summary": "Staff detail",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/characters": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Character & Staff"],
|
||||||
|
"summary": "Search characters",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "query", "in": "query", "required": true, "schema": { "type": "string" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/staff": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Character & Staff"],
|
||||||
|
"summary": "Search staff",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "query", "in": "query", "required": true, "schema": { "type": "string" } }
|
||||||
|
]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/info/{id}": {
|
"/api/info/{id}": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Anime Details"],
|
"tags": ["Anime Details"],
|
||||||
"summary": "Full anime info",
|
"summary": "Full anime info",
|
||||||
"operationId": "getAnimeInfo",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "AniList anime ID" }
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
],
|
]
|
||||||
"responses": { "200": { "description": "Complete anime metadata, characters, relations, recommendations" } }
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/anime/{id}/characters": {
|
"/api/anime/{id}/characters": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Anime Details"],
|
"tags": ["Anime Details"],
|
||||||
"summary": "Characters with voice actors",
|
"summary": "Characters",
|
||||||
"operationId": "getCharacters",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } },
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
]
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 25 } }
|
|
||||||
],
|
|
||||||
"responses": { "200": { "description": "Paginated character list" } }
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/anime/{id}/relations": {
|
"/api/anime/{id}/relations": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Anime Details"],
|
"tags": ["Anime Details"],
|
||||||
"summary": "Related anime",
|
"summary": "Relations",
|
||||||
"operationId": "getRelations",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
],
|
]
|
||||||
"responses": { "200": { "description": "Sequels, prequels, side stories, etc." } }
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/anime/{id}/recommendations": {
|
"/api/anime/{id}/recommendations": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Anime Details"],
|
"tags": ["Anime Details"],
|
||||||
"summary": "Community recommendations",
|
"summary": "Recommendations",
|
||||||
"operationId": "getRecommendations",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } },
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
{ "name": "page", "in": "query", "schema": { "type": "integer", "default": 1 } },
|
]
|
||||||
{ "name": "per_page", "in": "query", "schema": { "type": "integer", "default": 10 } }
|
|
||||||
],
|
|
||||||
"responses": { "200": { "description": "Recommended anime sorted by rating" } }
|
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/episodes/{id}": {
|
"/api/episodes/{id}": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Streaming"],
|
"tags": ["Streaming"],
|
||||||
"summary": "Episode list from all providers",
|
"summary": "Episode list",
|
||||||
"operationId": "getEpisodes",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" }, "description": "AniList anime ID" }
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
],
|
]
|
||||||
"responses": { "200": { "description": "Episodes organized by provider and audio type (sub/dub)" } }
|
}
|
||||||
|
},
|
||||||
|
"/api/episodes/{id}/batch": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Streaming"],
|
||||||
|
"summary": "Batch episode sources",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } },
|
||||||
|
{ "name": "provider", "in": "query", "schema": { "type": "string", "default": "kiwi" } },
|
||||||
|
{ "name": "category", "in": "query", "schema": { "type": "string", "default": "sub" } },
|
||||||
|
{ "name": "slugs", "in": "query", "schema": { "type": "string" } }
|
||||||
|
]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/sources": {
|
"/api/sources": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Streaming"],
|
"tags": ["Streaming"],
|
||||||
"summary": "Streaming sources (detailed)",
|
"summary": "Streaming sources (detailed)",
|
||||||
"operationId": "getSources",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "episodeId", "in": "query", "required": true, "schema": { "type": "string" } },
|
{ "name": "episodeId", "in": "query", "required": true, "schema": { "type": "string" } },
|
||||||
{ "name": "provider", "in": "query", "required": true, "schema": { "type": "string" } },
|
{ "name": "provider", "in": "query", "required": true, "schema": { "type": "string" } },
|
||||||
{ "name": "anilistId", "in": "query", "required": true, "schema": { "type": "integer" } },
|
{ "name": "anilistId", "in": "query", "required": true, "schema": { "type": "integer" } },
|
||||||
{ "name": "category", "in": "query", "schema": { "type": "string", "enum": ["sub", "dub"], "default": "sub" } }
|
{ "name": "category", "in": "query", "schema": { "type": "string", "default": "sub" } }
|
||||||
],
|
]
|
||||||
"responses": { "200": { "description": "M3U8 streams, subtitles, intro/outro timestamps" } }
|
}
|
||||||
|
},
|
||||||
|
"/api/stream": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Streaming"],
|
||||||
|
"summary": "Stream with quality fallback",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "provider", "in": "query", "required": true, "schema": { "type": "string" } },
|
||||||
|
{ "name": "anilistId", "in": "query", "required": true, "schema": { "type": "integer" } },
|
||||||
|
{ "name": "category", "in": "query", "schema": { "type": "string", "default": "sub" } },
|
||||||
|
{ "name": "slug", "in": "query", "required": true, "schema": { "type": "string" } },
|
||||||
|
{ "name": "quality", "in": "query", "schema": { "type": "string", "default": "1080p" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/download": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Streaming"],
|
||||||
|
"summary": "Download URL",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "provider", "in": "query", "required": true, "schema": { "type": "string" } },
|
||||||
|
{ "name": "anilistId", "in": "query", "required": true, "schema": { "type": "integer" } },
|
||||||
|
{ "name": "category", "in": "query", "schema": { "type": "string", "default": "sub" } },
|
||||||
|
{ "name": "slug", "in": "query", "required": true, "schema": { "type": "string" } }
|
||||||
|
]
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"/api/watch/{provider}/{anilistId}/{category}/{slug}": {
|
"/api/watch/{provider}/{anilistId}/{category}/{slug}": {
|
||||||
"get": {
|
"get": {
|
||||||
"tags": ["Streaming"],
|
"tags": ["Streaming"],
|
||||||
"summary": "Streaming sources (simple slug-based)",
|
"summary": "Streaming sources (simple)",
|
||||||
"operationId": "getWatchSources",
|
|
||||||
"parameters": [
|
"parameters": [
|
||||||
{ "name": "provider", "in": "path", "required": true, "schema": { "type": "string" } },
|
{ "name": "provider", "in": "path", "required": true, "schema": { "type": "string" } },
|
||||||
{ "name": "anilistId", "in": "path", "required": true, "schema": { "type": "integer" } },
|
{ "name": "anilistId", "in": "path", "required": true, "schema": { "type": "integer" } },
|
||||||
{ "name": "category", "in": "path", "required": true, "schema": { "type": "string", "enum": ["sub", "dub"] } },
|
{ "name": "category", "in": "path", "required": true, "schema": { "type": "string" } },
|
||||||
{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "e.g. animepahe-1" }
|
{ "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } }
|
||||||
],
|
]
|
||||||
"responses": { "200": { "description": "M3U8 streams, subtitles, intro/outro timestamps" } }
|
}
|
||||||
|
},
|
||||||
|
"/api/compare/{id1}/{id2}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Utility"],
|
||||||
|
"summary": "Compare two anime",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "id1", "in": "path", "required": true, "schema": { "type": "integer" } },
|
||||||
|
{ "name": "id2", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/stats/genre": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Utility"],
|
||||||
|
"summary": "Genre statistics"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/calendar": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Utility"],
|
||||||
|
"summary": "Monthly airing calendar",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "year", "in": "query", "schema": { "type": "integer" } },
|
||||||
|
{ "name": "month", "in": "query", "schema": { "type": "integer" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/timeline/{id}": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["Utility"],
|
||||||
|
"summary": "Anime timeline",
|
||||||
|
"parameters": [
|
||||||
|
{ "name": "id", "in": "path", "required": true, "schema": { "type": "integer" } }
|
||||||
|
]
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/health": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["System"],
|
||||||
|
"summary": "Health check"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/stats": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["System"],
|
||||||
|
"summary": "API statistics"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"/api/openapi": {
|
||||||
|
"get": {
|
||||||
|
"tags": ["System"],
|
||||||
|
"summary": "OpenAPI spec"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
}
|
||||||
"tags": [
|
|
||||||
{ "name": "System", "description": "Health & status" },
|
|
||||||
{ "name": "Search & Discovery", "description": "Search, suggestions, and advanced filtering" },
|
|
||||||
{ "name": "Collections", "description": "Trending, popular, upcoming, recent, spotlight, schedule" },
|
|
||||||
{ "name": "Anime Details", "description": "Full anime info, characters, relations, recommendations" },
|
|
||||||
{ "name": "Streaming", "description": "Episode lists and M3U8 streaming sources" }
|
|
||||||
]
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -5,9 +5,8 @@
|
|||||||
*
|
*
|
||||||
* @description
|
* @description
|
||||||
* Main entry point for the MiruroAPI Express server.
|
* Main entry point for the MiruroAPI Express server.
|
||||||
* Configures CORS, middleware, static files, Swagger docs,
|
* Configures CORS, compression, logging, security headers,
|
||||||
* API routes, and 404 handling. Starts the server on the
|
* rate limiting, API routes, and 404 handling.
|
||||||
* configured port.
|
|
||||||
*
|
*
|
||||||
* @exports
|
* @exports
|
||||||
* None (side-effect: starts Express server)
|
* None (side-effect: starts Express server)
|
||||||
@@ -19,7 +18,9 @@
|
|||||||
|
|
||||||
const express = require("express");
|
const express = require("express");
|
||||||
const cors = require("cors");
|
const cors = require("cors");
|
||||||
|
const compression = require("compression");
|
||||||
const path = require("path");
|
const path = require("path");
|
||||||
|
const fs = require("fs");
|
||||||
require("dotenv").config();
|
require("dotenv").config();
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
@@ -28,15 +29,63 @@ require("dotenv").config();
|
|||||||
|
|
||||||
const app = express();
|
const app = express();
|
||||||
const PORT = process.env.PORT || 3000;
|
const PORT = process.env.PORT || 3000;
|
||||||
|
const startTime = Date.now();
|
||||||
const allowedOrigins = process.env.ALLOWED_ORIGINS
|
const allowedOrigins = process.env.ALLOWED_ORIGINS
|
||||||
? process.env.ALLOWED_ORIGINS.split(",")
|
? process.env.ALLOWED_ORIGINS.split(",")
|
||||||
: null;
|
: null;
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// COMPRESSION
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Gzip compression — reduces response size by 30-70% ----
|
||||||
|
app.use(compression({
|
||||||
|
level: 6,
|
||||||
|
threshold: 1024,
|
||||||
|
filter: (req, res) => {
|
||||||
|
if (req.headers["x-no-compression"]) return false;
|
||||||
|
return compression.filter(req, res);
|
||||||
|
},
|
||||||
|
}));
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// REQUEST LOGGING
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Request logging — method, path, status, response time ----
|
||||||
|
app.use((req, res, next) => {
|
||||||
|
const start = Date.now();
|
||||||
|
const originalEnd = res.end;
|
||||||
|
|
||||||
|
res.end = function (...args) {
|
||||||
|
const duration = Date.now() - start;
|
||||||
|
const status = res.statusCode;
|
||||||
|
const ip =
|
||||||
|
req.headers["x-forwarded-for"]?.split(",")[0]?.trim() ||
|
||||||
|
req.ip ||
|
||||||
|
req.connection.remoteAddress;
|
||||||
|
|
||||||
|
// NOTE: Only log API requests, skip static files
|
||||||
|
if (req.path.startsWith("/api/")) {
|
||||||
|
const log = `[${new Date().toISOString()}] ${req.method} ${req.path} ${status} ${duration}ms ${ip}`;
|
||||||
|
if (status >= 400) {
|
||||||
|
console.error(log);
|
||||||
|
} else {
|
||||||
|
console.log(log);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
originalEnd.apply(this, args);
|
||||||
|
};
|
||||||
|
|
||||||
|
next();
|
||||||
|
});
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// CORS MIDDLEWARE
|
// CORS MIDDLEWARE
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
// NOTE: Single unified CORS middleware — handles all origin validation
|
// ---- FEATURE: Unified CORS middleware with preflight handling ----
|
||||||
app.use((req, res, next) => {
|
app.use((req, res, next) => {
|
||||||
const origin = req.headers.origin;
|
const origin = req.headers.origin;
|
||||||
if (
|
if (
|
||||||
@@ -46,36 +95,63 @@ app.use((req, res, next) => {
|
|||||||
) {
|
) {
|
||||||
res.setHeader("Access-Control-Allow-Origin", origin || "*");
|
res.setHeader("Access-Control-Allow-Origin", origin || "*");
|
||||||
}
|
}
|
||||||
res.setHeader("Access-Control-Allow-Methods", "GET");
|
res.setHeader("Access-Control-Allow-Methods", "GET, OPTIONS");
|
||||||
res.setHeader("Access-Control-Allow-Headers", "Content-Type");
|
res.setHeader("Access-Control-Allow-Headers", "Content-Type, X-No-Compression");
|
||||||
|
res.setHeader("Access-Control-Max-Age", "86400");
|
||||||
|
|
||||||
if (req.method === "OPTIONS") {
|
if (req.method === "OPTIONS") {
|
||||||
return res.status(204).end();
|
return res.status(204).end();
|
||||||
}
|
}
|
||||||
next();
|
next();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// SECURITY HEADERS
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
// ---- FEATURE: Security headers ----
|
// ---- FEATURE: Security headers ----
|
||||||
app.use((req, res, next) => {
|
app.use((req, res, next) => {
|
||||||
res.setHeader("X-Frame-Options", "DENY");
|
res.setHeader("X-Frame-Options", "DENY");
|
||||||
res.setHeader("X-Content-Type-Options", "nosniff");
|
res.setHeader("X-Content-Type-Options", "nosniff");
|
||||||
res.setHeader("X-XSS-Protection", "1; mode=block");
|
res.setHeader("Strict-Transport-Security", "max-age=31536000; includeSubDomains");
|
||||||
res.setHeader("Referrer-Policy", "strict-origin-when-cross-origin");
|
res.setHeader("Referrer-Policy", "strict-origin-when-cross-origin");
|
||||||
res.setHeader("Permissions-Policy", "camera=(), microphone=(), geolocation=()");
|
res.setHeader("Permissions-Policy", "camera=(), microphone=(), geolocation=()");
|
||||||
next();
|
next();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// CACHE HEADERS
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Cache-Control headers for API responses ----
|
||||||
|
app.use("/api", (req, res, next) => {
|
||||||
|
// NOTE: Different cache durations based on endpoint type
|
||||||
|
if (req.path.includes("/health") || req.path.includes("/stats")) {
|
||||||
|
res.setHeader("Cache-Control", "no-store");
|
||||||
|
} else if (req.path.includes("/search") || req.path.includes("/suggestions")) {
|
||||||
|
res.setHeader("Cache-Control", "public, max-age=60");
|
||||||
|
} else if (req.path.includes("/episodes") || req.path.includes("/sources") || req.path.includes("/watch")) {
|
||||||
|
res.setHeader("Cache-Control", "public, max-age=120");
|
||||||
|
} else {
|
||||||
|
res.setHeader("Cache-Control", "public, max-age=300");
|
||||||
|
}
|
||||||
|
res.setHeader("Vary", "Accept-Encoding");
|
||||||
|
next();
|
||||||
|
});
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// STATIC FILES
|
// STATIC FILES
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
app.use(express.static(path.join(__dirname, "public"), { redirect: false }));
|
app.use(express.static(path.join(__dirname, "public"), {
|
||||||
|
redirect: false,
|
||||||
|
maxAge: "1d",
|
||||||
|
}));
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// CLEAN URL ROUTES
|
// CLEAN URL ROUTES
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
// ---- FEATURE: Clean URL routes (no .html extension) ----
|
|
||||||
const fs = require("fs");
|
|
||||||
const publicDir = path.join(__dirname, "public");
|
const publicDir = path.join(__dirname, "public");
|
||||||
|
|
||||||
app.get("/tos", (req, res) => {
|
app.get("/tos", (req, res) => {
|
||||||
@@ -90,7 +166,6 @@ app.get("/privacy", (req, res) => {
|
|||||||
// SWAGGER UI DOCS
|
// SWAGGER UI DOCS
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
// ---- FEATURE: Interactive Swagger UI documentation at /docs ----
|
|
||||||
app.get("/docs", (req, res) => {
|
app.get("/docs", (req, res) => {
|
||||||
res.sendFile(path.join(publicDir, "docs.html"));
|
res.sendFile(path.join(publicDir, "docs.html"));
|
||||||
});
|
});
|
||||||
@@ -99,25 +174,9 @@ app.get("/docs", (req, res) => {
|
|||||||
// RESPONSE HELPERS
|
// RESPONSE HELPERS
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
// ---- FEATURE: Standardized JSON response wrapper ----
|
|
||||||
/**
|
|
||||||
* Wraps data in a standardized success JSON response.
|
|
||||||
*
|
|
||||||
* @param {object} res - Express response object
|
|
||||||
* @param {*} data - The data to return in the response
|
|
||||||
* @param {number} status - HTTP status code (default: 200)
|
|
||||||
*/
|
|
||||||
const jsonResponse = (res, data, status = 200) =>
|
const jsonResponse = (res, data, status = 200) =>
|
||||||
res.status(status).json({ success: true, results: data });
|
res.status(status).json({ success: true, results: data });
|
||||||
|
|
||||||
// ---- FEATURE: Standardized error response wrapper ----
|
|
||||||
/**
|
|
||||||
* Returns a standardized error JSON response.
|
|
||||||
*
|
|
||||||
* @param {object} res - Express response object
|
|
||||||
* @param {string} message - Error message to return
|
|
||||||
* @param {number} status - HTTP status code (default: 500)
|
|
||||||
*/
|
|
||||||
const jsonError = (res, message = "Internal server error", status = 500) =>
|
const jsonError = (res, message = "Internal server error", status = 500) =>
|
||||||
res.status(status).json({ success: false, message });
|
res.status(status).json({ success: false, message });
|
||||||
|
|
||||||
@@ -128,7 +187,10 @@ const jsonError = (res, message = "Internal server error", status = 500) =>
|
|||||||
// ---- FEATURE: Rate limiting (100 requests per minute per IP) ----
|
// ---- FEATURE: Rate limiting (100 requests per minute per IP) ----
|
||||||
const requestCounts = new Map();
|
const requestCounts = new Map();
|
||||||
app.use((req, res, next) => {
|
app.use((req, res, next) => {
|
||||||
const ip = req.ip || req.connection.remoteAddress;
|
const ip =
|
||||||
|
req.headers["x-forwarded-for"]?.split(",")[0]?.trim() ||
|
||||||
|
req.ip ||
|
||||||
|
req.connection.remoteAddress;
|
||||||
const now = Date.now();
|
const now = Date.now();
|
||||||
const windowMs = 60000;
|
const windowMs = 60000;
|
||||||
const maxRequests = 100;
|
const maxRequests = 100;
|
||||||
@@ -148,6 +210,16 @@ app.use((req, res, next) => {
|
|||||||
}
|
}
|
||||||
|
|
||||||
timestamps.push(now);
|
timestamps.push(now);
|
||||||
|
|
||||||
|
// NOTE: Periodic cleanup — prune expired IP entries when map grows large
|
||||||
|
if (requestCounts.size > 200) {
|
||||||
|
for (const [key, val] of requestCounts) {
|
||||||
|
if (val.filter((t) => now - t < windowMs).length === 0) {
|
||||||
|
requestCounts.delete(key);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
next();
|
next();
|
||||||
});
|
});
|
||||||
|
|
||||||
@@ -156,7 +228,7 @@ app.use((req, res, next) => {
|
|||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
const apiRoutes = require("./src/routes/apiRoutes");
|
const apiRoutes = require("./src/routes/apiRoutes");
|
||||||
app.use("/api", apiRoutes(jsonResponse, jsonError));
|
app.use("/api", apiRoutes(jsonResponse, jsonError, startTime));
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// 404 HANDLER
|
// 404 HANDLER
|
||||||
@@ -164,7 +236,7 @@ app.use("/api", apiRoutes(jsonResponse, jsonError));
|
|||||||
|
|
||||||
// ---- FEATURE: Global error handler ----
|
// ---- FEATURE: Global error handler ----
|
||||||
app.use((err, req, res, next) => {
|
app.use((err, req, res, next) => {
|
||||||
console.error(err.stack);
|
console.error(`[ERROR] ${err.message}`);
|
||||||
res.status(err.status || 500).json({
|
res.status(err.status || 500).json({
|
||||||
success: false,
|
success: false,
|
||||||
message: err.message || "Internal server error",
|
message: err.message || "Internal server error",
|
||||||
@@ -191,7 +263,7 @@ app.use((req, res) => {
|
|||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
app.listen(PORT, () => {
|
app.listen(PORT, () => {
|
||||||
console.info(`MiruroAPI listening at ${PORT}`);
|
console.log(`[${new Date().toISOString()}] MiruroAPI v2.0.0 listening at ${PORT}`);
|
||||||
});
|
});
|
||||||
|
|
||||||
module.exports = app;
|
module.exports = app;
|
||||||
|
|||||||
@@ -584,6 +584,341 @@ const filterAnime = async ({
|
|||||||
};
|
};
|
||||||
};
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// GENRES & CATEGORIES
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Get all available genres ----
|
||||||
|
/**
|
||||||
|
* Returns the complete list of AniList genres.
|
||||||
|
*
|
||||||
|
* @returns {Promise<Array>} Array of genre name strings
|
||||||
|
*/
|
||||||
|
const getAllGenres = async () => {
|
||||||
|
const gql = `query { GenreCollection }`;
|
||||||
|
const data = await anilistQuery(gql);
|
||||||
|
return data.GenreCollection;
|
||||||
|
};
|
||||||
|
|
||||||
|
// ---- FEATURE: Get all available tags ----
|
||||||
|
/**
|
||||||
|
* Returns the complete list of AniList tags with metadata.
|
||||||
|
*
|
||||||
|
* @returns {Promise<Array>} Array of tag objects { name, description, category, rank, isGeneralSpoiler, isMediaSpoiler, isAdult }
|
||||||
|
*/
|
||||||
|
const getAllTags = async () => {
|
||||||
|
const gql = `query { TagCollection { name description category rank isGeneralSpoiler isMediaSpoiler isAdult } }`;
|
||||||
|
const data = await anilistQuery(gql);
|
||||||
|
return data.TagCollection;
|
||||||
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// TOP & TRENDING
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Top anime by score (all time) ----
|
||||||
|
/**
|
||||||
|
* Fetches top-rated anime of all time sorted by score.
|
||||||
|
*
|
||||||
|
* @param {number} [page=1] - Page number
|
||||||
|
* @param {number} [perPage=20] - Results per page
|
||||||
|
* @returns {Promise<object>} Paginated top anime results
|
||||||
|
*/
|
||||||
|
const getTopAnime = async (page = 1, perPage = 20) => {
|
||||||
|
const gql = `
|
||||||
|
query ($page: Int, $perPage: Int) {
|
||||||
|
Page(page: $page, perPage: $perPage) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
media(type: ANIME, sort: SCORE_DESC) {
|
||||||
|
${MEDIA_LIST_FIELDS}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { page, perPage });
|
||||||
|
const pageData = data.Page;
|
||||||
|
|
||||||
|
return {
|
||||||
|
page: pageData.pageInfo.currentPage,
|
||||||
|
perPage: pageData.pageInfo.perPage,
|
||||||
|
total: pageData.pageInfo.total,
|
||||||
|
hasNextPage: pageData.pageInfo.hasNextPage,
|
||||||
|
results: pageData.media,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
// ---- FEATURE: Daily trending anime ----
|
||||||
|
/**
|
||||||
|
* Fetches currently trending anime (last 7 days).
|
||||||
|
*
|
||||||
|
* @param {number} [page=1] - Page number
|
||||||
|
* @param {number} [perPage=20] - Results per page
|
||||||
|
* @returns {Promise<object>} Paginated trending results
|
||||||
|
*/
|
||||||
|
const getTrendingDaily = async (page = 1, perPage = 20) => {
|
||||||
|
const gql = `
|
||||||
|
query ($page: Int, $perPage: Int) {
|
||||||
|
Page(page: $page, perPage: $perPage) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
media(type: ANIME, sort: TRENDING_DESC, trending: 7) {
|
||||||
|
${MEDIA_LIST_FIELDS}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { page, perPage });
|
||||||
|
const pageData = data.Page;
|
||||||
|
|
||||||
|
return {
|
||||||
|
page: pageData.pageInfo.currentPage,
|
||||||
|
perPage: pageData.pageInfo.perPage,
|
||||||
|
total: pageData.pageInfo.total,
|
||||||
|
hasNextPage: pageData.pageInfo.hasNextPage,
|
||||||
|
results: pageData.media,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
// ---- FEATURE: Weekly trending anime ----
|
||||||
|
/**
|
||||||
|
* Fetches currently trending anime (last 30 days).
|
||||||
|
*
|
||||||
|
* @param {number} [page=1] - Page number
|
||||||
|
* @param {number} [perPage=20] - Results per page
|
||||||
|
* @returns {Promise<object>} Paginated trending results
|
||||||
|
*/
|
||||||
|
const getTrendingWeekly = async (page = 1, perPage = 20) => {
|
||||||
|
const gql = `
|
||||||
|
query ($page: Int, $perPage: Int) {
|
||||||
|
Page(page: $page, perPage: $perPage) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
media(type: ANIME, sort: TRENDING_DESC, trending: 30) {
|
||||||
|
${MEDIA_LIST_FIELDS}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { page, perPage });
|
||||||
|
const pageData = data.Page;
|
||||||
|
|
||||||
|
return {
|
||||||
|
page: pageData.pageInfo.currentPage,
|
||||||
|
perPage: pageData.pageInfo.perPage,
|
||||||
|
total: pageData.pageInfo.total,
|
||||||
|
hasNextPage: pageData.pageInfo.hasNextPage,
|
||||||
|
results: pageData.media,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// SEASONAL & STUDIO
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Seasonal anime by year and season ----
|
||||||
|
/**
|
||||||
|
* Fetches anime for a specific season and year.
|
||||||
|
*
|
||||||
|
* @param {number} year - The year (e.g., 2025)
|
||||||
|
* @param {string} season - The season (WINTER, SPRING, SUMMER, FALL)
|
||||||
|
* @param {number} [page=1] - Page number
|
||||||
|
* @param {number} [perPage=20] - Results per page
|
||||||
|
* @returns {Promise<object>} Paginated seasonal anime results
|
||||||
|
*/
|
||||||
|
const getSeasonalAnime = async (year, season, page = 1, perPage = 20) => {
|
||||||
|
const gql = `
|
||||||
|
query ($year: Int, $season: MediaSeason, $page: Int, $perPage: Int) {
|
||||||
|
Page(page: $page, perPage: $perPage) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
media(type: ANIME, season: $season, seasonYear: $year, sort: POPULARITY_DESC) {
|
||||||
|
${MEDIA_LIST_FIELDS}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { year, season: season.toUpperCase(), page, perPage });
|
||||||
|
const pageData = data.Page;
|
||||||
|
|
||||||
|
return {
|
||||||
|
page: pageData.pageInfo.currentPage,
|
||||||
|
perPage: pageData.pageInfo.perPage,
|
||||||
|
total: pageData.pageInfo.total,
|
||||||
|
hasNextPage: pageData.pageInfo.hasNextPage,
|
||||||
|
results: pageData.media,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
// ---- FEATURE: Anime by studio name ----
|
||||||
|
/**
|
||||||
|
* Fetches all anime produced by a specific studio.
|
||||||
|
*
|
||||||
|
* @param {string} studioName - The studio name to search for
|
||||||
|
* @param {number} [page=1] - Page number
|
||||||
|
* @param {number} [perPage=20] - Results per page
|
||||||
|
* @returns {Promise<object>} Paginated studio anime results
|
||||||
|
*/
|
||||||
|
const getAnimeByStudio = async (studioName, page = 1, perPage = 20) => {
|
||||||
|
const gql = `
|
||||||
|
query ($name: String, $page: Int, $perPage: Int) {
|
||||||
|
Studio(search: $name) {
|
||||||
|
id name isAnimationStudio siteUrl
|
||||||
|
media(type: ANIME, sort: POPULARITY_DESC, page: $page, perPage: $perPage) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
nodes { ${MEDIA_LIST_FIELDS} }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { name: studioName, page, perPage });
|
||||||
|
const studio = data.Studio;
|
||||||
|
|
||||||
|
if (!studio) throw new Error("Studio not found");
|
||||||
|
|
||||||
|
return {
|
||||||
|
studio: {
|
||||||
|
id: studio.id,
|
||||||
|
name: studio.name,
|
||||||
|
isAnimationStudio: studio.isAnimationStudio,
|
||||||
|
siteUrl: studio.siteUrl,
|
||||||
|
},
|
||||||
|
page: studio.media.pageInfo.currentPage,
|
||||||
|
perPage: studio.media.pageInfo.perPage,
|
||||||
|
total: studio.media.pageInfo.total,
|
||||||
|
hasNextPage: studio.media.pageInfo.hasNextPage,
|
||||||
|
results: studio.media.nodes,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// CHARACTER & STAFF
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Character detail with anime list ----
|
||||||
|
/**
|
||||||
|
* Fetches detailed character info including all anime appearances.
|
||||||
|
*
|
||||||
|
* @param {number} id - AniList character ID
|
||||||
|
* @returns {Promise<object>} Character details with anime list
|
||||||
|
*/
|
||||||
|
const getCharacterInfo = async (id) => {
|
||||||
|
const gql = `
|
||||||
|
query ($id: Int) {
|
||||||
|
Character(id: $id) {
|
||||||
|
id name { full native userPreferred }
|
||||||
|
image { large medium }
|
||||||
|
description gender favourites siteUrl
|
||||||
|
dateOfBirth { year month day }
|
||||||
|
dateOfDeath { year month day }
|
||||||
|
age bloodType
|
||||||
|
media(perPage: 25, sort: POPULARITY_DESC) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
edges {
|
||||||
|
role
|
||||||
|
node { id title { romaji english } coverImage { large } format episodes status meanScore }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { id });
|
||||||
|
if (!data.Character) throw new Error("Character not found");
|
||||||
|
return data.Character;
|
||||||
|
};
|
||||||
|
|
||||||
|
// ---- FEATURE: Staff detail with anime list ----
|
||||||
|
/**
|
||||||
|
* Fetches detailed staff info including all anime works.
|
||||||
|
*
|
||||||
|
* @param {number} id - AniList staff ID
|
||||||
|
* @returns {Promise<object>} Staff details with anime list
|
||||||
|
*/
|
||||||
|
const getStaffInfo = async (id) => {
|
||||||
|
const gql = `
|
||||||
|
query ($id: Int) {
|
||||||
|
Staff(id: $id) {
|
||||||
|
id name { full native userPreferred }
|
||||||
|
image { large medium }
|
||||||
|
description gender favourites siteUrl
|
||||||
|
dateOfBirth { year month day }
|
||||||
|
dateOfDeath { year month day }
|
||||||
|
age homeTown yearsActive
|
||||||
|
staffMedia(perPage: 25, sort: POPULARITY_DESC) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
edges {
|
||||||
|
role
|
||||||
|
node { id title { romaji english } coverImage { large } format episodes status meanScore }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { id });
|
||||||
|
if (!data.Staff) throw new Error("Staff not found");
|
||||||
|
return data.Staff;
|
||||||
|
};
|
||||||
|
|
||||||
|
// ---- FEATURE: Search characters by name ----
|
||||||
|
/**
|
||||||
|
* Searches AniList characters by name.
|
||||||
|
*
|
||||||
|
* @param {string} query - Character name to search
|
||||||
|
* @param {number} [page=1] - Page number
|
||||||
|
* @param {number} [perPage=20] - Results per page
|
||||||
|
* @returns {Promise<object>} Paginated character search results
|
||||||
|
*/
|
||||||
|
const searchCharacters = async (query, page = 1, perPage = 20) => {
|
||||||
|
const gql = `
|
||||||
|
query ($search: String, $page: Int, $perPage: Int) {
|
||||||
|
Page(page: $page, perPage: $perPage) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
characters(search: $search, sort: SEARCH_MATCH) {
|
||||||
|
id name { full native userPreferred } image { large medium } gender favourites siteUrl
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { search: query, page, perPage });
|
||||||
|
const pageData = data.Page;
|
||||||
|
|
||||||
|
return {
|
||||||
|
page: pageData.pageInfo.currentPage,
|
||||||
|
perPage: pageData.pageInfo.perPage,
|
||||||
|
total: pageData.pageInfo.total,
|
||||||
|
hasNextPage: pageData.pageInfo.hasNextPage,
|
||||||
|
results: pageData.characters,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
// ---- FEATURE: Search staff by name ----
|
||||||
|
/**
|
||||||
|
* Searches AniList staff by name.
|
||||||
|
*
|
||||||
|
* @param {string} query - Staff name to search
|
||||||
|
* @param {number} [page=1] - Page number
|
||||||
|
* @param {number} [perPage=20] - Results per page
|
||||||
|
* @returns {Promise<object>} Paginated staff search results
|
||||||
|
*/
|
||||||
|
const searchStaff = async (query, page = 1, perPage = 20) => {
|
||||||
|
const gql = `
|
||||||
|
query ($search: String, $page: Int, $perPage: Int) {
|
||||||
|
Page(page: $page, perPage: $perPage) {
|
||||||
|
pageInfo { total currentPage lastPage hasNextPage perPage }
|
||||||
|
staff(search: $search, sort: SEARCH_MATCH) {
|
||||||
|
id name { full native userPreferred } image { large medium } gender favourites siteUrl
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
`;
|
||||||
|
const data = await anilistQuery(gql, { search: query, page, perPage });
|
||||||
|
const pageData = data.Page;
|
||||||
|
|
||||||
|
return {
|
||||||
|
page: pageData.pageInfo.currentPage,
|
||||||
|
perPage: pageData.pageInfo.perPage,
|
||||||
|
total: pageData.pageInfo.total,
|
||||||
|
hasNextPage: pageData.pageInfo.hasNextPage,
|
||||||
|
results: pageData.staff,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
module.exports = {
|
module.exports = {
|
||||||
anilistQuery,
|
anilistQuery,
|
||||||
searchAnime,
|
searchAnime,
|
||||||
@@ -596,6 +931,17 @@ module.exports = {
|
|||||||
getSpotlight,
|
getSpotlight,
|
||||||
getSchedule,
|
getSchedule,
|
||||||
filterAnime,
|
filterAnime,
|
||||||
|
getAllGenres,
|
||||||
|
getAllTags,
|
||||||
|
getTopAnime,
|
||||||
|
getTrendingDaily,
|
||||||
|
getTrendingWeekly,
|
||||||
|
getSeasonalAnime,
|
||||||
|
getAnimeByStudio,
|
||||||
|
getCharacterInfo,
|
||||||
|
getStaffInfo,
|
||||||
|
searchCharacters,
|
||||||
|
searchStaff,
|
||||||
MEDIA_LIST_FIELDS,
|
MEDIA_LIST_FIELDS,
|
||||||
MEDIA_FULL_FIELDS,
|
MEDIA_FULL_FIELDS,
|
||||||
};
|
};
|
||||||
|
|||||||
+18
-1
@@ -104,6 +104,15 @@ const setCache = (key, data, ttl = DEFAULT_TTL) => {
|
|||||||
cache.delete(firstKey);
|
cache.delete(firstKey);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// NOTE: Periodic cleanup — prune all expired entries when cache reaches 80% capacity
|
||||||
|
// Prevents unbounded memory growth from stale entries that were never accessed
|
||||||
|
if (cache.size >= MAX_CACHE_SIZE * 0.8) {
|
||||||
|
const now = Date.now();
|
||||||
|
for (const [k, v] of cache) {
|
||||||
|
if (now > v.expiry) cache.delete(k);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
cache.set(key, { data, expiry: Date.now() + ttl });
|
cache.set(key, { data, expiry: Date.now() + ttl });
|
||||||
};
|
};
|
||||||
|
|
||||||
@@ -120,6 +129,14 @@ const clearCache = () => {
|
|||||||
cache.clear();
|
cache.clear();
|
||||||
};
|
};
|
||||||
|
|
||||||
module.exports = { getCached, setCache, clearCache };
|
// ---- FEATURE: Get current cache size ----
|
||||||
|
/**
|
||||||
|
* Returns the current number of entries in the cache.
|
||||||
|
*
|
||||||
|
* @returns {number} Current cache size
|
||||||
|
*/
|
||||||
|
const getCacheSize = () => cache.size;
|
||||||
|
|
||||||
|
module.exports = { getCached, setCache, clearCache, getCacheSize };
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════ END: cache.js
|
// ══════════════════════════════════════════════════════════════ END: cache.js
|
||||||
|
|||||||
@@ -320,10 +320,152 @@ const getWatchSources = async (provider, anilistId, category, slug) => {
|
|||||||
return getSources(targetId, provider, anilistId, category);
|
return getSources(targetId, provider, anilistId, category);
|
||||||
};
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// SUBTITLE EXTRACTION
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Extract subtitle URLs from streaming sources ----
|
||||||
|
/**
|
||||||
|
* Extracts and formats subtitle URLs from the pipe sources response.
|
||||||
|
* Subtitles are usually in WebVTT format with language tags.
|
||||||
|
*
|
||||||
|
* @param {object} sources - The sources response from getSources/getWatchSources
|
||||||
|
* @returns {Array} Array of subtitle objects { url, label, language, format }
|
||||||
|
*/
|
||||||
|
const extractSubtitles = (sources) => {
|
||||||
|
const subtitles = sources.subtitles || sources.captions || [];
|
||||||
|
return subtitles.map((sub) => ({
|
||||||
|
url: sub.url || sub.file,
|
||||||
|
label: sub.label || sub.name || "Unknown",
|
||||||
|
language: sub.lang || sub.language || sub.label || "en",
|
||||||
|
format: sub.format || "vtt",
|
||||||
|
}));
|
||||||
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// QUALITY FALLBACK
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Get best available stream with quality fallback ----
|
||||||
|
/**
|
||||||
|
* Returns the best available HLS stream with automatic quality fallback.
|
||||||
|
* Tries 1080p → 720p → 360p in order.
|
||||||
|
*
|
||||||
|
* @param {object} sources - The sources response
|
||||||
|
* @param {string} [preferredQuality="1080p"] - Preferred quality
|
||||||
|
* @returns {object|null} Best available stream object or null
|
||||||
|
*/
|
||||||
|
const getBestStream = (sources, preferredQuality = "1080p") => {
|
||||||
|
const streams = (sources.streams || []).filter((s) => s.type === "hls" && s.url);
|
||||||
|
if (streams.length === 0) return null;
|
||||||
|
|
||||||
|
// NOTE: Try preferred quality first, then fallback
|
||||||
|
const qualityOrder = ["1080p", "720p", "480p", "360p"];
|
||||||
|
const startIdx = qualityOrder.indexOf(preferredQuality);
|
||||||
|
const ordered = startIdx >= 0
|
||||||
|
? qualityOrder.slice(startIdx)
|
||||||
|
: qualityOrder;
|
||||||
|
|
||||||
|
for (const q of ordered) {
|
||||||
|
const match = streams.find((s) => s.quality === q);
|
||||||
|
if (match) return match;
|
||||||
|
}
|
||||||
|
|
||||||
|
// NOTE: Return first available if no quality match
|
||||||
|
return streams[0];
|
||||||
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// DOWNLOAD URL
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Get download URL for an episode ----
|
||||||
|
/**
|
||||||
|
* Fetches the download URL for a specific episode from the pipe.
|
||||||
|
* Returns the direct download link if available.
|
||||||
|
*
|
||||||
|
* @param {string} provider - Provider name
|
||||||
|
* @param {number} anilistId - The AniList anime ID
|
||||||
|
* @param {string} category - Audio category ("sub" or "dub")
|
||||||
|
* @param {string} slug - Episode slug (e.g., "animepahe-1")
|
||||||
|
* @returns {Promise<object>} Object with download URL and metadata
|
||||||
|
*/
|
||||||
|
const getDownloadUrl = async (provider, anilistId, category, slug) => {
|
||||||
|
const sources = await getWatchSources(provider, anilistId, category, slug);
|
||||||
|
return {
|
||||||
|
download: sources.download || null,
|
||||||
|
provider,
|
||||||
|
anilistId,
|
||||||
|
category,
|
||||||
|
slug,
|
||||||
|
hasDownload: !!sources.download,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// BATCH EPISODES
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Get sources for multiple episodes at once ----
|
||||||
|
/**
|
||||||
|
* Fetches streaming sources for multiple episodes in parallel.
|
||||||
|
* Useful for preloading next episodes or batch downloading.
|
||||||
|
*
|
||||||
|
* @param {string} provider - Provider name
|
||||||
|
* @param {number} anilistId - The AniList anime ID
|
||||||
|
* @param {string} category - Audio category ("sub" or "dub")
|
||||||
|
* @param {string[]} slugs - Array of episode slugs (e.g., ["animepahe-1", "animepahe-2"])
|
||||||
|
* @returns {Promise<object>} Object mapping slug → sources (with errors for failed ones)
|
||||||
|
*/
|
||||||
|
const getBatchSources = async (provider, anilistId, category, slugs) => {
|
||||||
|
const results = {};
|
||||||
|
|
||||||
|
const fetchOne = async (slug) => {
|
||||||
|
try {
|
||||||
|
const sources = await getWatchSources(provider, anilistId, category, slug);
|
||||||
|
const best = getBestStream(sources);
|
||||||
|
const subtitles = extractSubtitles(sources);
|
||||||
|
results[slug] = {
|
||||||
|
success: true,
|
||||||
|
streams: sources.streams,
|
||||||
|
bestStream: best,
|
||||||
|
subtitles,
|
||||||
|
download: sources.download || null,
|
||||||
|
};
|
||||||
|
} catch (err) {
|
||||||
|
results[slug] = {
|
||||||
|
success: false,
|
||||||
|
error: err.message,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
// NOTE: Fetch up to 5 episodes in parallel to avoid rate limiting
|
||||||
|
const batchSize = 5;
|
||||||
|
for (let i = 0; i < slugs.length; i += batchSize) {
|
||||||
|
const batch = slugs.slice(i, i + batchSize);
|
||||||
|
await Promise.all(batch.map(fetchOne));
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
provider,
|
||||||
|
anilistId,
|
||||||
|
category,
|
||||||
|
total: slugs.length,
|
||||||
|
successful: Object.values(results).filter((r) => r.success).length,
|
||||||
|
failed: Object.values(results).filter((r) => !r.success).length,
|
||||||
|
episodes: results,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
module.exports = {
|
module.exports = {
|
||||||
getEpisodes,
|
getEpisodes,
|
||||||
getSources,
|
getSources,
|
||||||
getWatchSources,
|
getWatchSources,
|
||||||
|
getDownloadUrl,
|
||||||
|
getBatchSources,
|
||||||
|
extractSubtitles,
|
||||||
|
getBestStream,
|
||||||
encodePipeRequest,
|
encodePipeRequest,
|
||||||
decodePipeResponse,
|
decodePipeResponse,
|
||||||
translateId,
|
translateId,
|
||||||
|
|||||||
@@ -0,0 +1,72 @@
|
|||||||
|
/*
|
||||||
|
* ======= • ======= • ======= • ======= • =======• =======
|
||||||
|
* MiruroAPI — creatorInfo.js
|
||||||
|
* Repository: https://github.com/Shineii86/MiruroAPI
|
||||||
|
*
|
||||||
|
* @description
|
||||||
|
* Express middleware that injects creator attribution metadata
|
||||||
|
* into every JSON API response. Overrides res.json() to append
|
||||||
|
* author details and a server-side timestamp, unless the
|
||||||
|
* response already contains creator information.
|
||||||
|
*
|
||||||
|
* @exports
|
||||||
|
* addCreatorInfo — Express middleware function
|
||||||
|
* creatorInfo — Static creator metadata object
|
||||||
|
*
|
||||||
|
* @author Shinei Nouzen
|
||||||
|
* @license MIT
|
||||||
|
* ======= • ======= • ======= • ======= • =======• =======
|
||||||
|
*/
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// CREATOR METADATA
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// NOTE: Injected into every response unless `data.creator` already exists
|
||||||
|
const creatorInfo = {
|
||||||
|
creator: "Shinei Nouzen",
|
||||||
|
github: "https://github.com/Shineii86",
|
||||||
|
telegram: "https://telegram.me/Shineii86",
|
||||||
|
message: "Build with ❤️ by Shinei Nouzen",
|
||||||
|
};
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// MIDDLEWARE
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Express middleware that enriches every JSON response with
|
||||||
|
* creator attribution and an IN-formatted timestamp.
|
||||||
|
*
|
||||||
|
* @param {import('express').Request} req - Express request object
|
||||||
|
* @param {import('express').Response} res - Express response object
|
||||||
|
* @param {import('express').NextFunction} next - Passes control forward
|
||||||
|
* @returns {void}
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* app.use(addCreatorInfo);
|
||||||
|
* res.json({ anime: [...] });
|
||||||
|
* // Response includes creator, github, telegram, message, and timestamp
|
||||||
|
*/
|
||||||
|
const addCreatorInfo = (req, res, next) => {
|
||||||
|
// NOTE: Preserve the original json method so we can wrap it
|
||||||
|
const originalJson = res.json.bind(res);
|
||||||
|
|
||||||
|
// NOTE: Monkey-patch res.json to inject creator info
|
||||||
|
res.json = (data) => {
|
||||||
|
// NOTE: Only inject if data is a plain object and missing creator field
|
||||||
|
if (typeof data === "object" && data !== null && !data.creator) {
|
||||||
|
data = {
|
||||||
|
...data,
|
||||||
|
...creatorInfo,
|
||||||
|
timestamp: new Date().toLocaleString("en-IN", { timeZone: "Asia/Kolkata", hour12: true }),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
return originalJson(data);
|
||||||
|
};
|
||||||
|
|
||||||
|
next();
|
||||||
|
};
|
||||||
|
|
||||||
|
module.exports = { addCreatorInfo, creatorInfo };
|
||||||
|
// ══════════════════════════════════════════════════════════════ END: creatorInfo.js
|
||||||
+635
-38
@@ -7,7 +7,7 @@
|
|||||||
* Central API router that maps all Express GET endpoints to their
|
* Central API router that maps all Express GET endpoints to their
|
||||||
* corresponding handler functions. Each route wraps its handler
|
* corresponding handler functions. Each route wraps its handler
|
||||||
* in try/catch for consistent error handling. Includes health,
|
* in try/catch for consistent error handling. Includes health,
|
||||||
* stats, and OpenAPI specification endpoints.
|
* stats, streaming, and OpenAPI specification endpoints.
|
||||||
*
|
*
|
||||||
* @exports
|
* @exports
|
||||||
* createApiRoutes - Function that registers all API routes
|
* createApiRoutes - Function that registers all API routes
|
||||||
@@ -21,36 +21,30 @@ const express = require("express");
|
|||||||
const anilist = require("../helpers/anilist");
|
const anilist = require("../helpers/anilist");
|
||||||
const pipe = require("../helpers/pipe");
|
const pipe = require("../helpers/pipe");
|
||||||
const { getCached, setCache } = require("../helpers/cache");
|
const { getCached, setCache } = require("../helpers/cache");
|
||||||
|
const { addCreatorInfo } = require("../middleware/creatorInfo");
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// ROUTE REGISTRATION
|
// ROUTE REGISTRATION
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
// ---- FEATURE: Main API route registration function ----
|
const createApiRoutes = (jsonResponse, jsonError, startTime) => {
|
||||||
/**
|
|
||||||
* Registers all API routes on the Express app.
|
|
||||||
* Receives response helpers for consistent JSON formatting.
|
|
||||||
*
|
|
||||||
* @param {object} app - Express application instance
|
|
||||||
* @param {function} jsonResponse - Standardized success response wrapper
|
|
||||||
* @param {function} jsonError - Standardized error response wrapper
|
|
||||||
* @returns {express.Router} Configured router
|
|
||||||
*/
|
|
||||||
const createApiRoutes = (jsonResponse, jsonError) => {
|
|
||||||
const router = express.Router();
|
const router = express.Router();
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// REQUEST COUNTER (must be before all routes)
|
// CREATOR ATTRIBUTION (must be before all routes)
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
const startTime = Date.now();
|
router.use(addCreatorInfo);
|
||||||
let requestCount = 0;
|
|
||||||
let errorCount = 0;
|
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// REQUEST COUNTER
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
const requestCount = { total: 0, errors: 0 };
|
||||||
router.use((req, res, next) => {
|
router.use((req, res, next) => {
|
||||||
requestCount++;
|
requestCount.total++;
|
||||||
res.on("finish", () => {
|
res.on("finish", () => {
|
||||||
if (res.statusCode >= 400) errorCount++;
|
if (res.statusCode >= 400) requestCount.errors++;
|
||||||
});
|
});
|
||||||
next();
|
next();
|
||||||
});
|
});
|
||||||
@@ -88,7 +82,6 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
let result = getCached(cacheKey);
|
let result = getCached(cacheKey);
|
||||||
if (!result) {
|
if (!result) {
|
||||||
result = await anilist.getSuggestions(query);
|
result = await anilist.getSuggestions(query);
|
||||||
// NOTE: Cache suggestions longer (2 minutes) — they change less frequently
|
|
||||||
setCache(cacheKey, result, 120 * 1000);
|
setCache(cacheKey, result, 120 * 1000);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -120,6 +113,30 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Multi-parameter search (query + filters combined) ----
|
||||||
|
router.get("/multi-search", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { q, genre, tag, year, season, format, status, sort = "SEARCH_MATCH", page = 1, per_page = 20 } = req.query;
|
||||||
|
|
||||||
|
// NOTE: If only query is provided, use regular search
|
||||||
|
if (q && !genre && !tag && !year && !season && !format && !status) {
|
||||||
|
const result = await anilist.searchAnime(q, parseInt(page), parseInt(per_page));
|
||||||
|
return jsonResponse(res, result);
|
||||||
|
}
|
||||||
|
|
||||||
|
// NOTE: If filters only, use filter endpoint
|
||||||
|
const result = await anilist.filterAnime({
|
||||||
|
genre, tag, year: year ? parseInt(year) : null,
|
||||||
|
season, format, status, sort,
|
||||||
|
page: parseInt(page), perPage: parseInt(per_page),
|
||||||
|
});
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// COLLECTIONS
|
// COLLECTIONS
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
@@ -133,7 +150,42 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
let result = getCached(cacheKey);
|
let result = getCached(cacheKey);
|
||||||
if (!result) {
|
if (!result) {
|
||||||
result = await anilist.getCollection("TRENDING_DESC", null, parseInt(page), parseInt(per_page));
|
result = await anilist.getCollection("TRENDING_DESC", null, parseInt(page), parseInt(per_page));
|
||||||
// NOTE: Cache trending for 2 minutes — changes less frequently than search
|
setCache(cacheKey, result, 120 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Daily trending anime ----
|
||||||
|
router.get("/trending/daily", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `trending:daily:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getTrendingDaily(parseInt(page), parseInt(per_page));
|
||||||
|
setCache(cacheKey, result, 120 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Weekly trending anime ----
|
||||||
|
router.get("/trending/weekly", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `trending:weekly:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getTrendingWeekly(parseInt(page), parseInt(per_page));
|
||||||
setCache(cacheKey, result, 120 * 1000);
|
setCache(cacheKey, result, 120 * 1000);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -161,6 +213,24 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Top anime by score (all time) ----
|
||||||
|
router.get("/top", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `top:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getTopAnime(parseInt(page), parseInt(per_page));
|
||||||
|
setCache(cacheKey, result, 300 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
// ---- FEATURE: Most anticipated upcoming anime ----
|
// ---- FEATURE: Most anticipated upcoming anime ----
|
||||||
router.get("/upcoming", async (req, res) => {
|
router.get("/upcoming", async (req, res) => {
|
||||||
try {
|
try {
|
||||||
@@ -231,6 +301,259 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Next 10 episodes airing soon ----
|
||||||
|
router.get("/upcoming/countdown", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const cacheKey = "upcoming:countdown";
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getSchedule(1, 10);
|
||||||
|
setCache(cacheKey, result, 60 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Random anime of the day ----
|
||||||
|
router.get("/random", async (req, res) => {
|
||||||
|
try {
|
||||||
|
// NOTE: Get random page from trending to ensure variety
|
||||||
|
const randomPage = Math.floor(Math.random() * 50) + 1;
|
||||||
|
const data = await anilist.getCollection("POPULARITY_DESC", null, randomPage, 1);
|
||||||
|
const anime = data.results[0];
|
||||||
|
|
||||||
|
if (!anime) return jsonError(res, "No anime found", 404);
|
||||||
|
jsonResponse(res, anime);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// SEASONAL & STUDIO
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Seasonal anime by year and season ----
|
||||||
|
router.get("/season/:year/:season", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { year, season } = req.params;
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `season:${year}:${season}:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getSeasonalAnime(parseInt(year), season, parseInt(page), parseInt(per_page));
|
||||||
|
setCache(cacheKey, result, 300 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Anime by studio name ----
|
||||||
|
router.get("/studio/:name", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { name } = req.params;
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `studio:${name}:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getAnimeByStudio(decodeURIComponent(name), parseInt(page), parseInt(per_page));
|
||||||
|
setCache(cacheKey, result, 300 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// GENRES & TAGS
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Get all available genres ----
|
||||||
|
router.get("/genres", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const cacheKey = "genres";
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getAllGenres();
|
||||||
|
setCache(cacheKey, result, 86400 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Get all available tags ----
|
||||||
|
router.get("/tags", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const cacheKey = "tags";
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getAllTags();
|
||||||
|
setCache(cacheKey, result, 86400 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Anime by genre name ----
|
||||||
|
router.get("/genre/:name", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { name } = req.params;
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `genre:${name}:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.filterAnime({ genre: decodeURIComponent(name), page: parseInt(page), perPage: parseInt(per_page) });
|
||||||
|
setCache(cacheKey, result, 120 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Anime by year ----
|
||||||
|
router.get("/year/:year", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { year } = req.params;
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `year:${year}:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.filterAnime({ year: parseInt(year), page: parseInt(page), perPage: parseInt(per_page) });
|
||||||
|
setCache(cacheKey, result, 300 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Anime by status ----
|
||||||
|
router.get("/status/:status", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { status } = req.params;
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `status:${status}:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.filterAnime({ status, page: parseInt(page), perPage: parseInt(per_page) });
|
||||||
|
setCache(cacheKey, result, 120 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Anime by format ----
|
||||||
|
router.get("/format/:format", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { format } = req.params;
|
||||||
|
const { page = 1, per_page = 20 } = req.query;
|
||||||
|
const cacheKey = `format:${format}:${page}:${per_page}`;
|
||||||
|
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.filterAnime({ format, page: parseInt(page), perPage: parseInt(per_page) });
|
||||||
|
setCache(cacheKey, result, 300 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// CHARACTER & STAFF
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Character detail with anime list ----
|
||||||
|
router.get("/character/:id", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const id = parseInt(req.params.id);
|
||||||
|
if (isNaN(id)) return jsonError(res, "Invalid character ID", 400);
|
||||||
|
|
||||||
|
const cacheKey = `character:${id}`;
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getCharacterInfo(id);
|
||||||
|
setCache(cacheKey, result, 600 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Staff detail with anime list ----
|
||||||
|
router.get("/staff/:id", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const id = parseInt(req.params.id);
|
||||||
|
if (isNaN(id)) return jsonError(res, "Invalid staff ID", 400);
|
||||||
|
|
||||||
|
const cacheKey = `staff:${id}`;
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
result = await anilist.getStaffInfo(id);
|
||||||
|
setCache(cacheKey, result, 600 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Search characters ----
|
||||||
|
router.get("/characters", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { query, page = 1, per_page = 20 } = req.query;
|
||||||
|
if (!query) return jsonError(res, "query parameter is required", 400);
|
||||||
|
|
||||||
|
const result = await anilist.searchCharacters(query, parseInt(page), parseInt(per_page));
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Search staff ----
|
||||||
|
router.get("/staff", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { query, page = 1, per_page = 20 } = req.query;
|
||||||
|
if (!query) return jsonError(res, "query parameter is required", 400);
|
||||||
|
|
||||||
|
const result = await anilist.searchStaff(query, parseInt(page), parseInt(per_page));
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// ANIME DETAILS
|
// ANIME DETAILS
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
@@ -245,7 +568,6 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
let result = getCached(cacheKey);
|
let result = getCached(cacheKey);
|
||||||
if (!result) {
|
if (!result) {
|
||||||
result = await anilist.getAnimeInfo(id);
|
result = await anilist.getAnimeInfo(id);
|
||||||
// NOTE: Cache info for 5 minutes — detailed data changes infrequently
|
|
||||||
setCache(cacheKey, result, 300 * 1000);
|
setCache(cacheKey, result, 300 * 1000);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -291,7 +613,7 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// STREAMING
|
// STREAMING & DOWNLOADING
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
// ---- FEATURE: Episode list from all providers ----
|
// ---- FEATURE: Episode list from all providers ----
|
||||||
@@ -304,7 +626,6 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
let result = getCached(cacheKey);
|
let result = getCached(cacheKey);
|
||||||
if (!result) {
|
if (!result) {
|
||||||
result = await pipe.getEpisodes(id);
|
result = await pipe.getEpisodes(id);
|
||||||
// NOTE: Cache episodes for 2 minutes — episode lists change during airing
|
|
||||||
setCache(cacheKey, result, 120 * 1000);
|
setCache(cacheKey, result, 120 * 1000);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -314,6 +635,23 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Batch episode sources ----
|
||||||
|
router.get("/episodes/:id/batch", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const id = parseInt(req.params.id);
|
||||||
|
const { provider = "kiwi", category = "sub", slugs } = req.query;
|
||||||
|
|
||||||
|
if (isNaN(id)) return jsonError(res, "Invalid AniList ID", 400);
|
||||||
|
if (!slugs) return jsonError(res, "slugs parameter is required (comma-separated)", 400);
|
||||||
|
|
||||||
|
const slugList = slugs.split(",").map((s) => s.trim());
|
||||||
|
const result = await pipe.getBatchSources(provider, id, category, slugList);
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
// ---- FEATURE: Streaming sources (detailed/manual endpoint) ----
|
// ---- FEATURE: Streaming sources (detailed/manual endpoint) ----
|
||||||
router.get("/sources", async (req, res) => {
|
router.get("/sources", async (req, res) => {
|
||||||
try {
|
try {
|
||||||
@@ -329,6 +667,43 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Streaming sources with quality fallback ----
|
||||||
|
router.get("/stream", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { provider, anilistId, category = "sub", slug, quality = "1080p" } = req.query;
|
||||||
|
if (!provider || !anilistId || !slug) {
|
||||||
|
return jsonError(res, "provider, anilistId, and slug are required", 400);
|
||||||
|
}
|
||||||
|
|
||||||
|
const sources = await pipe.getWatchSources(provider, parseInt(anilistId), category, slug);
|
||||||
|
const bestStream = pipe.getBestStream(sources, quality);
|
||||||
|
const subtitles = pipe.extractSubtitles(sources);
|
||||||
|
|
||||||
|
jsonResponse(res, {
|
||||||
|
...sources,
|
||||||
|
bestStream,
|
||||||
|
subtitles,
|
||||||
|
});
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Download URL for an episode ----
|
||||||
|
router.get("/download", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { provider, anilistId, category = "sub", slug } = req.query;
|
||||||
|
if (!provider || !anilistId || !slug) {
|
||||||
|
return jsonError(res, "provider, anilistId, and slug are required", 400);
|
||||||
|
}
|
||||||
|
|
||||||
|
const result = await pipe.getDownloadUrl(provider, parseInt(anilistId), category, slug);
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
// ---- FEATURE: Streaming sources (simple slug-based endpoint) ----
|
// ---- FEATURE: Streaming sources (simple slug-based endpoint) ----
|
||||||
router.get("/watch/:provider/:anilistId/:category/:slug", async (req, res) => {
|
router.get("/watch/:provider/:anilistId/:category/:slug", async (req, res) => {
|
||||||
try {
|
try {
|
||||||
@@ -340,6 +715,194 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
// UTILITY FEATURES
|
||||||
|
// ══════════════════════════════════════════════════════════════
|
||||||
|
|
||||||
|
// ---- FEATURE: Compare two anime side by side ----
|
||||||
|
router.get("/compare/:id1/:id2", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const id1 = parseInt(req.params.id1);
|
||||||
|
const id2 = parseInt(req.params.id2);
|
||||||
|
if (isNaN(id1) || isNaN(id2)) return jsonError(res, "Invalid anime IDs", 400);
|
||||||
|
|
||||||
|
const cacheKey = `compare:${id1}:${id2}`;
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
const [anime1, anime2] = await Promise.all([
|
||||||
|
anilist.getAnimeInfo(id1),
|
||||||
|
anilist.getAnimeInfo(id2),
|
||||||
|
]);
|
||||||
|
|
||||||
|
result = {
|
||||||
|
anime1: {
|
||||||
|
id: anime1.id,
|
||||||
|
title: anime1.title,
|
||||||
|
coverImage: anime1.coverImage,
|
||||||
|
format: anime1.format,
|
||||||
|
episodes: anime1.episodes,
|
||||||
|
duration: anime1.duration,
|
||||||
|
status: anime1.status,
|
||||||
|
averageScore: anime1.averageScore,
|
||||||
|
meanScore: anime1.meanScore,
|
||||||
|
popularity: anime1.popularity,
|
||||||
|
favourites: anime1.favourites,
|
||||||
|
genres: anime1.genres,
|
||||||
|
studios: anime1.studios,
|
||||||
|
},
|
||||||
|
anime2: {
|
||||||
|
id: anime2.id,
|
||||||
|
title: anime2.title,
|
||||||
|
coverImage: anime2.coverImage,
|
||||||
|
format: anime2.format,
|
||||||
|
episodes: anime2.episodes,
|
||||||
|
duration: anime2.duration,
|
||||||
|
status: anime2.status,
|
||||||
|
averageScore: anime2.averageScore,
|
||||||
|
meanScore: anime2.meanScore,
|
||||||
|
popularity: anime2.popularity,
|
||||||
|
favourites: anime2.favourites,
|
||||||
|
genres: anime2.genres,
|
||||||
|
studios: anime2.studios,
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
setCache(cacheKey, result, 600 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Genre statistics ----
|
||||||
|
router.get("/stats/genre", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const cacheKey = "stats:genre";
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
const genres = await anilist.getAllGenres();
|
||||||
|
const stats = {};
|
||||||
|
|
||||||
|
// NOTE: Fetch top anime for each genre (limited to avoid rate limiting)
|
||||||
|
for (const genre of genres.slice(0, 10)) {
|
||||||
|
try {
|
||||||
|
const data = await anilist.filterAnime({ genre, perPage: 1 });
|
||||||
|
stats[genre] = {
|
||||||
|
total: data.total,
|
||||||
|
topAnime: data.results[0] || null,
|
||||||
|
};
|
||||||
|
} catch {
|
||||||
|
stats[genre] = { total: 0, topAnime: null };
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
result = { genres, stats };
|
||||||
|
setCache(cacheKey, result, 86400 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Monthly airing calendar ----
|
||||||
|
router.get("/calendar", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const { year, month } = req.query;
|
||||||
|
const now = new Date();
|
||||||
|
const y = year ? parseInt(year) : now.getFullYear();
|
||||||
|
const m = month ? parseInt(month) : now.getMonth() + 1;
|
||||||
|
|
||||||
|
const cacheKey = `calendar:${y}:${m}`;
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
// NOTE: Get airing schedule for the month
|
||||||
|
const schedule = await anilist.getSchedule(1, 50);
|
||||||
|
const monthStart = new Date(y, m - 1, 1);
|
||||||
|
const monthEnd = new Date(y, m, 0, 23, 59, 59);
|
||||||
|
|
||||||
|
const monthAnime = schedule.results.filter((item) => {
|
||||||
|
const airDate = new Date(item.airingAt * 1000);
|
||||||
|
return airDate >= monthStart && airDate <= monthEnd;
|
||||||
|
});
|
||||||
|
|
||||||
|
// NOTE: Group by date
|
||||||
|
const calendar = {};
|
||||||
|
monthAnime.forEach((item) => {
|
||||||
|
const date = new Date(item.airingAt * 1000).toISOString().split("T")[0];
|
||||||
|
if (!calendar[date]) calendar[date] = [];
|
||||||
|
calendar[date].push({
|
||||||
|
id: item.id,
|
||||||
|
title: item.title,
|
||||||
|
coverImage: item.coverImage,
|
||||||
|
episode: item.next_episode,
|
||||||
|
airingAt: item.airingAt,
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
result = {
|
||||||
|
year: y,
|
||||||
|
month: m,
|
||||||
|
totalAiring: monthAnime.length,
|
||||||
|
calendar,
|
||||||
|
};
|
||||||
|
setCache(cacheKey, result, 3600 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
// ---- FEATURE: Anime timeline (release history) ----
|
||||||
|
router.get("/timeline/:id", async (req, res) => {
|
||||||
|
try {
|
||||||
|
const id = parseInt(req.params.id);
|
||||||
|
if (isNaN(id)) return jsonError(res, "Invalid AniList ID", 400);
|
||||||
|
|
||||||
|
const cacheKey = `timeline:${id}`;
|
||||||
|
let result = getCached(cacheKey);
|
||||||
|
if (!result) {
|
||||||
|
const info = await anilist.getAnimeInfo(id);
|
||||||
|
const relations = await anilist.getAnimeRelations(id);
|
||||||
|
|
||||||
|
// NOTE: Build timeline from relations
|
||||||
|
const timeline = relations.relations
|
||||||
|
.filter((r) => ["PREQUEL", "SEQUEL", "SIDE_STORY", "SPIN_OFF", "ADAPTATION", "SOURCE"].includes(r.relationType))
|
||||||
|
.map((r) => ({
|
||||||
|
id: r.node.id,
|
||||||
|
title: r.node.title,
|
||||||
|
coverImage: r.node.coverImage,
|
||||||
|
format: r.node.format,
|
||||||
|
status: r.node.status,
|
||||||
|
episodes: r.node.episodes,
|
||||||
|
meanScore: r.node.meanScore,
|
||||||
|
relation: r.relationType,
|
||||||
|
}));
|
||||||
|
|
||||||
|
result = {
|
||||||
|
id: info.id,
|
||||||
|
title: info.title,
|
||||||
|
startDate: info.startDate,
|
||||||
|
endDate: info.endDate,
|
||||||
|
status: info.status,
|
||||||
|
episodes: info.episodes,
|
||||||
|
timeline,
|
||||||
|
};
|
||||||
|
|
||||||
|
setCache(cacheKey, result, 600 * 1000);
|
||||||
|
}
|
||||||
|
|
||||||
|
jsonResponse(res, result);
|
||||||
|
} catch (err) {
|
||||||
|
jsonError(res, err.message);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
// HEALTH & STATS
|
// HEALTH & STATS
|
||||||
// ══════════════════════════════════════════════════════════════
|
// ══════════════════════════════════════════════════════════════
|
||||||
@@ -355,7 +918,7 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
success: true,
|
success: true,
|
||||||
results: {
|
results: {
|
||||||
status: "healthy",
|
status: "healthy",
|
||||||
version: "1.2.0",
|
version: "2.0.0",
|
||||||
uptime: `${hours}h ${minutes}m ${seconds}s`,
|
uptime: `${hours}h ${minutes}m ${seconds}s`,
|
||||||
uptimeSeconds: uptime,
|
uptimeSeconds: uptime,
|
||||||
timestamp: new Date().toISOString(),
|
timestamp: new Date().toISOString(),
|
||||||
@@ -363,8 +926,13 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
memory: {
|
memory: {
|
||||||
used: Math.round(process.memoryUsage().heapUsed / 1024 / 1024) + "MB",
|
used: Math.round(process.memoryUsage().heapUsed / 1024 / 1024) + "MB",
|
||||||
total: Math.round(process.memoryUsage().heapTotal / 1024 / 1024) + "MB",
|
total: Math.round(process.memoryUsage().heapTotal / 1024 / 1024) + "MB",
|
||||||
|
rss: Math.round(process.memoryUsage().rss / 1024 / 1024) + "MB",
|
||||||
},
|
},
|
||||||
endpoints: 16,
|
cache: {
|
||||||
|
size: require("../helpers/cache").getCacheSize(),
|
||||||
|
maxSize: 100,
|
||||||
|
},
|
||||||
|
endpoints: 35,
|
||||||
providers: ["kiwi", "pewe", "bee", "bonk", "bun", "ally", "nun", "twin", "cog", "moo", "hop", "telli"],
|
providers: ["kiwi", "pewe", "bee", "bonk", "bun", "ally", "nun", "twin", "cog", "moo", "hop", "telli"],
|
||||||
},
|
},
|
||||||
});
|
});
|
||||||
@@ -379,19 +947,20 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
results: {
|
results: {
|
||||||
uptime: uptime + "s",
|
uptime: uptime + "s",
|
||||||
requests: {
|
requests: {
|
||||||
total: requestCount,
|
total: requestCount.total,
|
||||||
errors: errorCount,
|
errors: requestCount.errors,
|
||||||
successRate: requestCount > 0
|
successRate: requestCount.total > 0
|
||||||
? ((1 - errorCount / requestCount) * 100).toFixed(1) + "%"
|
? ((1 - requestCount.errors / requestCount.total) * 100).toFixed(1) + "%"
|
||||||
: "100%",
|
: "100%",
|
||||||
},
|
},
|
||||||
cache: {
|
cache: {
|
||||||
type: "in-memory",
|
type: "in-memory",
|
||||||
ttl: "1 minute (default), 2-5 minutes for collections",
|
ttl: "1 minute (default), 2-5 minutes for collections, 24 hours for genres/tags",
|
||||||
maxSize: 100,
|
maxSize: 100,
|
||||||
|
currentSize: require("../helpers/cache").getCacheSize(),
|
||||||
description: "Map-based cache with TTL expiration and FIFO eviction",
|
description: "Map-based cache with TTL expiration and FIFO eviction",
|
||||||
},
|
},
|
||||||
endpoints: 16,
|
endpoints: 35,
|
||||||
timestamp: new Date().toISOString(),
|
timestamp: new Date().toISOString(),
|
||||||
},
|
},
|
||||||
});
|
});
|
||||||
@@ -404,7 +973,7 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
info: {
|
info: {
|
||||||
title: "MiruroAPI",
|
title: "MiruroAPI",
|
||||||
description: "Free REST API for anime streaming data — AniList GraphQL + Miruro streaming providers",
|
description: "Free REST API for anime streaming data — AniList GraphQL + Miruro streaming providers",
|
||||||
version: "1.2.0",
|
version: "2.0.0",
|
||||||
contact: { name: "Shineii86", url: "https://github.com/Shineii86/MiruroAPI" },
|
contact: { name: "Shineii86", url: "https://github.com/Shineii86/MiruroAPI" },
|
||||||
},
|
},
|
||||||
servers: [
|
servers: [
|
||||||
@@ -414,28 +983,56 @@ const createApiRoutes = (jsonResponse, jsonError) => {
|
|||||||
"/search": { get: { summary: "Search anime", tags: ["Search"] } },
|
"/search": { get: { summary: "Search anime", tags: ["Search"] } },
|
||||||
"/suggestions": { get: { summary: "Autocomplete suggestions", tags: ["Search"] } },
|
"/suggestions": { get: { summary: "Autocomplete suggestions", tags: ["Search"] } },
|
||||||
"/filter": { get: { summary: "Advanced filter", tags: ["Search"] } },
|
"/filter": { get: { summary: "Advanced filter", tags: ["Search"] } },
|
||||||
|
"/multi-search": { get: { summary: "Multi-parameter search", tags: ["Search"] } },
|
||||||
"/trending": { get: { summary: "Trending anime", tags: ["Collections"] } },
|
"/trending": { get: { summary: "Trending anime", tags: ["Collections"] } },
|
||||||
|
"/trending/daily": { get: { summary: "Daily trending", tags: ["Collections"] } },
|
||||||
|
"/trending/weekly": { get: { summary: "Weekly trending", tags: ["Collections"] } },
|
||||||
"/popular": { get: { summary: "Most popular", tags: ["Collections"] } },
|
"/popular": { get: { summary: "Most popular", tags: ["Collections"] } },
|
||||||
|
"/top": { get: { summary: "Top by score", tags: ["Collections"] } },
|
||||||
"/upcoming": { get: { summary: "Upcoming anime", tags: ["Collections"] } },
|
"/upcoming": { get: { summary: "Upcoming anime", tags: ["Collections"] } },
|
||||||
"/recent": { get: { summary: "Recently aired", tags: ["Collections"] } },
|
"/recent": { get: { summary: "Recently aired", tags: ["Collections"] } },
|
||||||
"/spotlight": { get: { summary: "Spotlight anime", tags: ["Collections"] } },
|
"/spotlight": { get: { summary: "Spotlight anime", tags: ["Collections"] } },
|
||||||
"/schedule": { get: { summary: "Airing schedule", tags: ["Collections"] } },
|
"/schedule": { get: { summary: "Airing schedule", tags: ["Collections"] } },
|
||||||
|
"/random": { get: { summary: "Random anime", tags: ["Collections"] } },
|
||||||
|
"/season/{year}/{season}": { get: { summary: "Seasonal anime", tags: ["Seasonal & Studio"] } },
|
||||||
|
"/studio/{name}": { get: { summary: "Anime by studio", tags: ["Seasonal & Studio"] } },
|
||||||
|
"/genres": { get: { summary: "All genres", tags: ["Genres & Tags"] } },
|
||||||
|
"/tags": { get: { summary: "All tags", tags: ["Genres & Tags"] } },
|
||||||
|
"/genre/{name}": { get: { summary: "Anime by genre", tags: ["Genres & Tags"] } },
|
||||||
|
"/year/{year}": { get: { summary: "Anime by year", tags: ["Genres & Tags"] } },
|
||||||
|
"/status/{status}": { get: { summary: "Anime by status", tags: ["Genres & Tags"] } },
|
||||||
|
"/format/{format}": { get: { summary: "Anime by format", tags: ["Genres & Tags"] } },
|
||||||
|
"/character/{id}": { get: { summary: "Character detail", tags: ["Character & Staff"] } },
|
||||||
|
"/staff/{id}": { get: { summary: "Staff detail", tags: ["Character & Staff"] } },
|
||||||
|
"/characters": { get: { summary: "Search characters", tags: ["Character & Staff"] } },
|
||||||
|
"/staff": { get: { summary: "Search staff", tags: ["Character & Staff"] } },
|
||||||
"/info/{id}": { get: { summary: "Full anime info", tags: ["Anime Details"] } },
|
"/info/{id}": { get: { summary: "Full anime info", tags: ["Anime Details"] } },
|
||||||
"/anime/{id}/characters": { get: { summary: "Characters", tags: ["Anime Details"] } },
|
"/anime/{id}/characters": { get: { summary: "Characters", tags: ["Anime Details"] } },
|
||||||
"/anime/{id}/relations": { get: { summary: "Relations", tags: ["Anime Details"] } },
|
"/anime/{id}/relations": { get: { summary: "Relations", tags: ["Anime Details"] } },
|
||||||
"/anime/{id}/recommendations": { get: { summary: "Recommendations", tags: ["Anime Details"] } },
|
"/anime/{id}/recommendations": { get: { summary: "Recommendations", tags: ["Anime Details"] } },
|
||||||
"/episodes/{id}": { get: { summary: "Episode list", tags: ["Streaming"] } },
|
"/episodes/{id}": { get: { summary: "Episode list", tags: ["Streaming & Downloading"] } },
|
||||||
"/sources": { get: { summary: "Streaming sources (detailed)", tags: ["Streaming"] } },
|
"/episodes/{id}/batch": { get: { summary: "Batch episode sources", tags: ["Streaming & Downloading"] } },
|
||||||
"/watch/{provider}/{anilistId}/{category}/{slug}": { get: { summary: "Streaming sources (simple)", tags: ["Streaming"] } },
|
"/sources": { get: { summary: "Streaming sources (detailed)", tags: ["Streaming & Downloading"] } },
|
||||||
|
"/stream": { get: { summary: "Stream with quality fallback", tags: ["Streaming & Downloading"] } },
|
||||||
|
"/download": { get: { summary: "Download URL", tags: ["Streaming & Downloading"] } },
|
||||||
|
"/watch/{provider}/{anilistId}/{category}/{slug}": { get: { summary: "Streaming sources (simple)", tags: ["Streaming & Downloading"] } },
|
||||||
|
"/compare/{id1}/{id2}": { get: { summary: "Compare two anime", tags: ["Utility"] } },
|
||||||
|
"/stats/genre": { get: { summary: "Genre statistics", tags: ["Utility"] } },
|
||||||
|
"/calendar": { get: { summary: "Monthly calendar", tags: ["Utility"] } },
|
||||||
|
"/timeline/{id}": { get: { summary: "Anime timeline", tags: ["Utility"] } },
|
||||||
"/health": { get: { summary: "Health check", tags: ["System"] } },
|
"/health": { get: { summary: "Health check", tags: ["System"] } },
|
||||||
"/stats": { get: { summary: "API statistics", tags: ["System"] } },
|
"/stats": { get: { summary: "API statistics", tags: ["System"] } },
|
||||||
"/openapi": { get: { summary: "OpenAPI spec", tags: ["System"] } },
|
"/openapi": { get: { summary: "OpenAPI spec", tags: ["System"] } },
|
||||||
},
|
},
|
||||||
tags: [
|
tags: [
|
||||||
{ name: "Search", description: "Search & filter" },
|
{ name: "Search", description: "Search, filter, suggestions" },
|
||||||
{ name: "Collections", description: "Trending, popular, upcoming, schedule" },
|
{ name: "Collections", description: "Trending, popular, top, schedule" },
|
||||||
|
{ name: "Seasonal & Studio", description: "Seasonal anime, studio filter" },
|
||||||
|
{ name: "Genres & Tags", description: "Genre, year, status, format filters" },
|
||||||
|
{ name: "Character & Staff", description: "Character/staff details and search" },
|
||||||
{ name: "Anime Details", description: "Info, characters, relations, recommendations" },
|
{ name: "Anime Details", description: "Info, characters, relations, recommendations" },
|
||||||
{ name: "Streaming", description: "Episodes, sources, watch" },
|
{ name: "Streaming & Downloading", description: "Episodes, sources, stream, download" },
|
||||||
|
{ name: "Utility", description: "Compare, stats, calendar, timeline" },
|
||||||
{ name: "System", description: "Health, stats, OpenAPI" },
|
{ name: "System", description: "Health, stats, OpenAPI" },
|
||||||
],
|
],
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -4,8 +4,8 @@
|
|||||||
* Repository: https://github.com/Shineii86/MiruroAPI
|
* Repository: https://github.com/Shineii86/MiruroAPI
|
||||||
*
|
*
|
||||||
* @description
|
* @description
|
||||||
* Integration test suite for MiruroAPI endpoints.
|
* Integration test suite for MiruroAPI v2.0.0 endpoints.
|
||||||
* Tests all major endpoints for correct response format.
|
* Tests all 35 endpoints for correct response format.
|
||||||
*
|
*
|
||||||
* @author Shinei Nouzen
|
* @author Shinei Nouzen
|
||||||
* @license MIT
|
* @license MIT
|
||||||
@@ -15,24 +15,66 @@
|
|||||||
const BASE = process.env.API_URL || "https://mirurotvapi.vercel.app/api";
|
const BASE = process.env.API_URL || "https://mirurotvapi.vercel.app/api";
|
||||||
|
|
||||||
const tests = [
|
const tests = [
|
||||||
|
// System
|
||||||
{ name: "Health", url: "/health" },
|
{ name: "Health", url: "/health" },
|
||||||
{ name: "Stats", url: "/stats" },
|
{ name: "Stats", url: "/stats" },
|
||||||
{ name: "OpenAPI", url: "/openapi" },
|
{ name: "OpenAPI", url: "/openapi" },
|
||||||
|
|
||||||
|
// Search & Discovery
|
||||||
{ name: "Search", url: "/search?query=naruto" },
|
{ name: "Search", url: "/search?query=naruto" },
|
||||||
{ name: "Suggestions", url: "/suggestions?query=naruto" },
|
{ name: "Suggestions", url: "/suggestions?query=naruto" },
|
||||||
{ name: "Filter", url: "/filter?genre=Action&per_page=1" },
|
{ name: "Filter", url: "/filter?genre=Action&per_page=1" },
|
||||||
|
{ name: "Multi-Search", url: "/multi-search?q=naruto&genre=Action" },
|
||||||
|
|
||||||
|
// Collections
|
||||||
{ name: "Trending", url: "/trending?per_page=1" },
|
{ name: "Trending", url: "/trending?per_page=1" },
|
||||||
|
{ name: "Trending Daily", url: "/trending/daily" },
|
||||||
|
{ name: "Trending Weekly", url: "/trending/weekly" },
|
||||||
{ name: "Popular", url: "/popular?per_page=1" },
|
{ name: "Popular", url: "/popular?per_page=1" },
|
||||||
|
{ name: "Top", url: "/top?per_page=1" },
|
||||||
{ name: "Upcoming", url: "/upcoming?per_page=1" },
|
{ name: "Upcoming", url: "/upcoming?per_page=1" },
|
||||||
{ name: "Recent", url: "/recent?per_page=1" },
|
{ name: "Recent", url: "/recent?per_page=1" },
|
||||||
{ name: "Spotlight", url: "/spotlight" },
|
{ name: "Spotlight", url: "/spotlight" },
|
||||||
{ name: "Schedule", url: "/schedule" },
|
{ name: "Schedule", url: "/schedule" },
|
||||||
|
{ name: "Random", url: "/random" },
|
||||||
|
{ name: "Upcoming Countdown", url: "/upcoming/countdown" },
|
||||||
|
|
||||||
|
// Seasonal & Studio
|
||||||
|
{ name: "Seasonal", url: "/season/2025/spring" },
|
||||||
|
{ name: "Studio", url: "/studio/MAPPA" },
|
||||||
|
|
||||||
|
// Genres & Tags
|
||||||
|
{ name: "Genres", url: "/genres" },
|
||||||
|
{ name: "Tags", url: "/tags" },
|
||||||
|
{ name: "Genre", url: "/genre/Action" },
|
||||||
|
{ name: "Year", url: "/year/2024" },
|
||||||
|
{ name: "Status", url: "/status/RELEASING" },
|
||||||
|
{ name: "Format", url: "/format/MOVIE" },
|
||||||
|
|
||||||
|
// Character & Staff
|
||||||
|
{ name: "Character", url: "/character/1" },
|
||||||
|
{ name: "Staff", url: "/staff/1" },
|
||||||
|
{ name: "Characters Search", url: "/characters?query=kaneki" },
|
||||||
|
{ name: "Staff Search", url: "/staff?query=oda" },
|
||||||
|
|
||||||
|
// Anime Details
|
||||||
{ name: "Info", url: "/info/20" },
|
{ name: "Info", url: "/info/20" },
|
||||||
{ name: "Characters", url: "/anime/20/characters" },
|
{ name: "Anime Characters", url: "/anime/20/characters" },
|
||||||
{ name: "Relations", url: "/anime/20/relations" },
|
{ name: "Relations", url: "/anime/20/relations" },
|
||||||
{ name: "Recommendations", url: "/anime/20/recommendations" },
|
{ name: "Recommendations", url: "/anime/20/recommendations" },
|
||||||
|
|
||||||
|
// Streaming
|
||||||
{ name: "Episodes", url: "/episodes/20" },
|
{ name: "Episodes", url: "/episodes/20" },
|
||||||
|
{ name: "Batch Episodes", url: "/episodes/20/batch?provider=kiwi&category=sub&slugs=animepahe-1,animepahe-2" },
|
||||||
|
{ name: "Stream", url: "/stream?provider=kiwi&anilistId=20&category=sub&slug=animepahe-1" },
|
||||||
|
{ name: "Download", url: "/download?provider=kiwi&anilistId=20&category=sub&slug=animepahe-1" },
|
||||||
{ name: "Watch", url: "/watch/kiwi/20/sub/animepahe-1" },
|
{ name: "Watch", url: "/watch/kiwi/20/sub/animepahe-1" },
|
||||||
|
|
||||||
|
// Utility
|
||||||
|
{ name: "Compare", url: "/compare/20/21" },
|
||||||
|
{ name: "Genre Stats", url: "/stats/genre" },
|
||||||
|
{ name: "Calendar", url: "/calendar" },
|
||||||
|
{ name: "Timeline", url: "/timeline/20" },
|
||||||
];
|
];
|
||||||
|
|
||||||
let passed = 0;
|
let passed = 0;
|
||||||
@@ -61,7 +103,7 @@ async function runTest(test) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
async function runAll() {
|
async function runAll() {
|
||||||
console.log(`\n🧪 Running ${tests.length} tests...\n`);
|
console.log(`\n🧪 MiruroAPI v2.0.0 — Running ${tests.length} tests...\n`);
|
||||||
|
|
||||||
for (const test of tests) {
|
for (const test of tests) {
|
||||||
await runTest(test);
|
await runTest(test);
|
||||||
|
|||||||
+5
-10
@@ -1,13 +1,8 @@
|
|||||||
{
|
{
|
||||||
"version": 2,
|
"functions": {
|
||||||
"builds": [
|
"api/index.js": {
|
||||||
{
|
"includeFiles": "src/**",
|
||||||
"src": "server.js",
|
"maxDuration": 30
|
||||||
"use": "@vercel/node"
|
|
||||||
}
|
}
|
||||||
],
|
}
|
||||||
"routes": [
|
|
||||||
{ "src": "/api/(.*)", "dest": "server.js" },
|
|
||||||
{ "src": "/(.*)", "dest": "server.js" }
|
|
||||||
]
|
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user