makhembu/african-stream-api

African movie streaming API aggregator — TMDB + Africa streaming sources # African Stream API — Express API for African Streaming Content A comprehensive Express API server wrapping the WeFeed/123Movies API for African content. Supports search, filtering, streaming with token rotation, staff/filmography data, captions, comments, and subtitle proxying (SRT-to-VTT). Includes a vidsrc sub-application for extracting streams from Vidlink.pro and StreamProvider via Go WASM-based token generation. ## Quick Start ```bash git clone github.com cd african-api cp .env.example .env npm install npm start # Server running at localhost ``` Requires `AUTH_TOKEN` and optionally `BROWSERLESS_TOKEN` in `.env`. ## API ### Main API (`/api`) | Method | Path | Description | |--------|------|-------------| | GET | `/api/health` | System status and environment | | GET | `/api/search?q=query&page=&perPage=` | Search movies and shows by keyword | | GET | `/api/filter?country=&channelId=&page=&perPage=&sort=` | Filter by country, channel, sort | | GET | `/api/detail?path=` | Content metadata by detail path | | GET | `/api/stream?id=&path=&se=&ep=` | Streaming URL with token rotation and fallback | | GET | `/api/african-movies?page=` | Aggregated SA + Nollywood + Showmax content | | GET | `/api/staff-detail?path=` | Staff biography | | GET | `/api/staff-subjects?id=&page=&perPage=` | Staff filmography | | GET | `/api/detail-rec?id=&page=&perPage=` | Related recommendations | | GET | `/api/comments?id=&page=&perPage=` | User comments | | GET | `/api/caption?id=&subjectId=&path=` | Stream subtitles | | GET | `/api/proxy-video?url=` | Direct video proxy | | GET | `/api/proxy-subtitle?url=` | Subtitle proxy with SRT-to-VTT conversion | | GET | `/api/refresh-token-manual` | Manual token refresh via Browserless.io | ### Vidsrc API (`/vidlink`) | Method | Path | Description | |--------|------|-------------| | GET | `/vidlink/movie?tmdb=ID` | Stream from StreamProvider | | GET | `/vidlink/tv?tmdb=ID&season=N&episode=M` …