The ultimate REST API for MovieBox.ph. 🚀 Optimized for high-speed metadata scraping, real-time stream extraction, and seamless frontend integration.
- 🏠 Comprehensive Homepage: Instant access to Banners, Trending Now, Hot, Cinema, and custom Operating categories.
- 🔍 Advanced Search: Real-time keyword suggestions and full-text search results.
- 📱 Tabbed Navigation: Fully functional endpoints for Movies, TV Series, Animation, and Rankings.
- 🗃️ Deep Metadata: Extraction of IMDb ratings, release dates, high-res posters, genres, and dub/sub lists.
▶️ Direct Streaming: Direct.mp4and HLS stream retrieval with automatic server discovery and Cloudflare bypass.- ⚡ High Performance: Built with FastAPI and Httpx for asynchronous, non-blocking requests.
- Backend: FastAPI (Python)
- Networking: Httpx (Async HTTP Client)
- Parsing: BeautifulSoup4 & Regex (NUXT_DATA Parsing)
- Deployment: Uvicorn
- Python 3.9 or higher
pip(Python package installer)
-
Clone the repository:
git clone https://github.com/walterwhite-69/Moviebox-API.git cd Moviebox-API -
Install dependencies:
pip install -r requirements.txt
Note: If requirements.txt is missing, install manually:
pip install fastapi uvicorn httpx beautifulsoup4 -
Start the server:
uvicorn api:app --host 0.0.0.0 --port 8000 --reload
| Endpoint | Description |
|---|---|
GET /home |
Full homepage data including banners and all sections. |
GET /home/banner |
Return only active featured banner items. |
GET /home/sections |
List all available section names and movie counts. |
GET /home/trending |
Get "Trending Now" specific items. |
| Endpoint | Description |
|---|---|
GET /movies |
Fetch the full movie filter page. |
GET /tv-series |
Fetch the full TV series catalog. |
GET /animation |
Fetch animated series and anime. |
GET /ranking |
Get most-watched and top-rated rankings. |
| Endpoint | Description |
|---|---|
GET /search?q={query} |
Search for any title. |
GET /search/suggest?q={query} |
Get autocomplete suggestions. |
GET /detail/{slug} |
Get full metadata and available stream links. |
GET /api/stream/{id}?detail_path={slug} |
Raw Stream URL Discovery. |
Run the built-in verification suite to ensure all endpoints are pointing to the live backend correctly:
python verify.pyContributions, issues, and feature requests are welcome! Feel free to check the issues page.
Distributed under the MIT License. See LICENSE for more information.
Made by walter for the Streaming Community