https://radio.menhagmuslim.com/api/v1
/api/v1/quran/surahs
{
"status": "success",
"count": 114,
"data": [
{
"number": 1,
"name": "الفاتحة",
"name_en": "Al-Fatihah",
"ayahs": 7,
"type": "مكية",
"type_en": "Meccan",
"page": 1,
"revelation_order": 5
},
...
]
}
/api/v1/quran/surahs/{number}
/api/v1/quran/reciters
| search | string (optional) | search=عبد الباسط | |
| has_audios | boolean (optional) | has_audios=true | |
| per_page | integer (optional) | per_page=20 |
/api/v1/quran/reciters/{id_or_slug}
/api/v1/quran/reciters/{id_or_slug}/playlist
{
"status": "success",
"reciter": {
"id": 1,
"name": "مشاري راشد العفاسي",
"slug": "mishary-alafasy"
},
"total_tracks": 114,
"playlist": [
{
"id": 101,
"surah_number": 1,
"surah_number_formatted": "001",
"surah_name": "الفاتحة",
"surah_name_en": "Al-Fatihah",
"audio_url": "https://.../001.mp3",
"download_url": "https://.../001.mp3",
"plays_count": 4820
},
...
]
}
/api/v1/quran/featured
/api/v1/quran/audios/{id}/play
/api/v1/categories
/api/v1/scholars
/api/v1/scholars/{id_or_slug}
/api/v1/series
/api/v1/series/{id_or_slug}
/api/v1/series/{id_or_slug}/playlist
/api/v1/lessons
/api/v1/lessons/featured
/api/v1/lessons/{id_or_slug}
/api/v1/lessons/{id}/play
/api/v1/radio/status
{
"is_live": true,
"listeners_count": 142,
"stream_url": "https://.../stream",
"current_track": {
"title": "سورة يوسف - تلاوة خاشعة",
"scholar": "الشيخ عبد الباسط عبد الصمد",
"duration": 1840,
"elapsed_seconds": 325,
"progress_percentage": 17.6,
"audio_url": "https://.../012.mp3"
},
"server_time": "2026-09-11T00:10:00Z"
}
/api/v1/radio/schedule
/api/v1/search?q={query}
import 'dart:convert'; import 'package:http/http.dart' as http; import 'package:just_audio/just_audio.dart'; class MenhagAudioService { static const String baseUrl = 'https://radio.menhagmuslim.com/api/v1'; final AudioPlayer _player = AudioPlayer(); /// Fetch reciter continuous playlist and stream seamlessly Future<void> playReciterSurahs(String reciterSlug) async { final uri = Uri.parse('$baseUrl/quran/reciters/$reciterSlug/playlist'); final response = await http.get(uri); if (response.statusCode == 200) { final data = json.decode(response.body); final List tracks = data['playlist']; // Build continuous concatenating audio playlist final playlist = ConcatenatingAudioSource( children: tracks.map((track) { return AudioSource.uri( Uri.parse(track['audio_url']), tag: track['surah_name'], ); }).toList(), ); await _player.setAudioSource(playlist); _player.play(); } } }