API Version 3

Overview

Get a list of all avalibale languages, with all sura,rewayah and reciters for each language

يمكنك هنا استعراض جميع اللغات المتاحة مع عرض لروابط السور والروايات و القراء لكل لغة

Resource URL
https://mp3quran.net/api/v3/languages
Example Request
GET https://mp3quran.net/api/v3/languages
Example Response
                                
{
language: [
{
id: "1",
language: "Arabic",
native: "العربية",
surah: "https://www.mp3quran.net/api/v3/suwar?language=ar",
rewayah: "https://www.mp3quran.net/api/v3/riwayat?language=ar",
reciters: "https://www.mp3quran.net/api/v3/reciters?language=ar"
},
{
id: "2",
language: "English",
native: "English",
surah: "https://www.mp3quran.net/api/v3/suwar?language=eng",
rewayah: "https://www.mp3quran.net/api/v3/riwayat?language=eng",
reciters: "https://www.mp3quran.net/api/v3/reciters?language=eng"
},
{
id: "3",
language: "French",
native: "Français",
surah: "https://www.mp3quran.net/api/v3/suwar?language=fr",
rewayah: "https://www.mp3quran.net/api/v3/riwayat?language=fr",
reciters: "https://www.mp3quran.net/api/v3/reciters?language=fr"
}]
                            
Overview
Get a list of all available Surah with selected lanaguage with display the surah type ( Makki - Madani) and the page number for the beginning and end as in MUSHAF ALMADINAH

يمكنك هنا استعراض جميع اسماء سور القران للغة محددة مع بيان المكي والمدني منها و أرقام الصفحات لكل سورة ( البداية والنهاية ) حسب مصحف المدينة

Resource URL
https://mp3quran.net/api/v3/suwar
Parameters
Name Required Description Default Value Example
language optional The language of texts in ٍSurah arrays. If is not set the default language of texts is arabic. 'ar', 'eng', 'fr', 'ru', 'de',  'es',  'tr',  'cn',  'th',  'ur',  'bn',  'bs',  'ug',  'fa',  'tg',  'ml',  'tl',  'id',  'pt',  'ha',  'sw', 
Example Request
GET https://mp3quran.net/api/v3/suwar?language=eng
Example Response
                                
{
    "suwar": [
        {
            "id": 1,
            "name": "Al-Fatihah ",
            "start_page": 1,
            "end_page": 1,
            "makkia": 1
        },
        {
            "id": 2,
            "name": "Al-Baqarah ",
            "start_page": 2,
            "end_page": 49,
            "makkia": 0
        },
        {
            "id": 3,
            "name": "Al-Imran ",
            "start_page": 50,
            "end_page": 76,
            "makkia": 0
        }
    ]
}
                            
Overview
Get a list of all avalibale Rewayah for each language.

يمكنك هنا استعراض جميع اسماء الروايات لكل لغة

Resource URL
https://mp3quran.net/api/v3/riwayat
Parameters
Name Required Description Default Value Example
language optional The language of texts in riwayat arrays. If is not set the default language of texts is arabic. 'ar', 'eng', 'fr', 'ru', 'de',  'es',  'tr',  'cn',  'th',  'ur',  'bn',  'bs',  'ug',  'fa',  'tg',  'ml',  'tl',  'id',  'pt',  'ha',  'sw', 
Example Request
GET https://mp3quran.net/api/v3/riwayat?language=eng
Example Response
                                
{
    "riwayat": [
        {
            "id": 1,
            "name": "Rewayat Hafs A'n Assem"
        },
        {
            "id": 10,
            "name": "Rewayat Warsh A'n Nafi' Men  Tariq Abi Baker Alasbahani"
        },
        {
            "id": 11,
            "name": "Rewayat Albizi and Qunbol A'n Ibn Katheer"
        }
    ]
}
                            
Overview
Get a list of all available reciters with many options:

1-Get all reciters for a specific language by selecting a language code.
2-Get a specific reciter by selecting his code number.
3-Get all reciters if they have a specific rewayah, i.e., display all reciters if they have the rewayah name :WARSH A’N NAFI’.
4-Get all reciters if they have a specific surah, i.e., get all reciters if they have Surah ALKAHF
5-Get all the reciters if they have surah ALKAHF and the rewayah name is HAFS AN ASIM.

هنا يمكنك عرض كل اسماء القراء مع عدة خيارات متنوعة:

**يمكنك عرض اسماء كل القراء بلغة محددة عن طريق اختيار رمز اللغة**
** عرض قارئ محدد فقط عن طريق اختيار رقم القارئ**
** عرض كل القراء الذين لهم رواية محددة ، مثلا إظهار كل القراء الذين لديهم رواية ورش عن نافع**
** عرض كل القراء الذين لهم سورة محددة ، مثلا إظهار كل القراء الذين لديهم سورة الكهف**
**يمكنك عرض كل القراء الذين لديهم سورة الكهف و رواية حفص عن عاصم**

Resource URL
https://mp3quran.net/api/v3/reciters
Parameters
Name Required Description Default Value Example
language optional The language of texts in reads arrays. If is not set the default language of texts is arabic. 'ar', 'eng', 'fr', 'ru', 'de',  'es',  'tr',  'cn',  'th',  'ur',  'bn',  'bs',  'ug',  'fa',  'tg',  'ml',  'tl',  'id',  'pt',  'ha',  'sw', 
reciter optional The id of the reciter you want to get its reads. If is not set it will return all reciters reads.
rewaya optional The id of the rewaya you want to get its reads. If is not set it will return all reciters reads
sura optional The id of the sura you want to get its reads. If is not set it will return all reciters reads
Example Request
GET https://www.mp3quran.net/api/v3/reciters?language=eng
Example Response
			
{
reciters: [
{
id: 1,
name: "Ibrahim Al-Akdar",
letter: "I",
moshaf: [
{
id: 1,
name: "Rewayat Hafs A'n Assem - ",
server: "https://server6.mp3quran.net/akdr/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34"
} ] },
{
id: 10,
name: "Akram Alalaqmi",
letter: "A",
moshaf: [
{
id: 10,
name: "Rewayat Hafs A'n Assem - ",
server: "https://server9.mp3quran.net/akrm/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34"
}]}
}
			
            
Example Request
GET https://www.mp3quran.net/api/v3/reciters?language=eng&reciter=168
Example Response
			
{
reciters: [
{
id: 168,
name: "Hazza Al-Balushi",
letter: "H",
moshaf: [
{
id: 187,
moshaf_type: 116,
name: "Rewayat Hafs A'n Assem - Murattal",
server: "https://server11.mp3quran.net/hazza/",
surah_total: 75,
surah_list: "1,13,14,15,18,19,25,29,30,31,36,37,38,39,40,42,44,47,49,50,"
}]}]}
			
            
Example Request
GET https://www.mp3quran.net/api/v3/reciters?language=eng&reciter=199&rewaya=5
Example Response
			
{
reciters: [
{
id: 199,
name: "Ahmad Deban",
letter: "A",
moshaf: [
{
id: 259,
moshaf_type: 516,
name: "Rewayat Qalon A'n Nafi' - Murattal",
server: "https://server16.mp3quran.net/deban/Rewayat-Qalon-A-n-Nafi/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,"
}]}]}			
            
Example Request
GET https://www.mp3quran.net/api/v3/reciters?language=eng&rewaya=1&sura=18
Example Response
			
{
reciters: [
{
id: 1,
name: "Ibrahim Al-Akdar",
letter: "I",
moshaf: [
{
id: 1,
name: "Rewayat Hafs A'n Assem - ",
server: "https://server6.mp3quran.net/akdr/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,"
}]},
{
id: 10,
name: "Akram Alalaqmi",
letter: "A",
moshaf: [
{
id: 10,
name: "Rewayat Hafs A'n Assem - ",
server: "https://server9.mp3quran.net/akrm/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,"
}]}

			
            
Example Request
GET https://www.mp3quran.net/api/v3/reciters?language=eng&sura=18
Example Response
			
{
reciters: [
id: 103,
name: "Mohammad Abdullkarem",
letter: "M",
moshaf: [
{
id: 171,
name: "Rewayat Warsh A'n Nafi' Men  Tariq Abi Baker Alasbahani - ",
server: "https://server12.mp3quran.net/m_krm/Rewayat-Warsh-A-n-Nafi-Men-Tariq-Abi-Baker-Alasbahani/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28"
},
{
id: 110,
name: "Rewayat Hafs A'n Assem - ",
server: "https://server12.mp3quran.net/m_krm/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28"
}]},
{
id: 104,
name: "Mohammad Al-Abdullah",
letter: "M",
moshaf: [
{
id: 112,
name: "Rewayat AlDorai A'n Al-Kisa'ai - Murattal",
server: "https://server9.mp3quran.net/abdullah/Rewayat-AlDorai-A-n-Al-Kisa-ai/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,"
},
{
id: 111,
name: "Rewayat Albizi and Qunbol A'n Ibn Katheer - Murattal",
server: "https://server9.mp3quran.net/abdullah/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,"
}
			
            
Overview
Get a list of all avalibale reads ordered by added date.

يمكنك هنا استعراض القراء بحسب تاريخ الإضافة ، ( الأحدث أولا)

Resource URL
https://mp3quran.net/api/v3/recent_reads
Parameters
Name Required Description Default Value Example
language optional The language of texts in reads arrays. If is not set the default language of texts is arabic. 'ar', 'eng', 'fr', 'ru', 'de',  'es',  'tr',  'cn',  'th',  'ur',  'bn',  'bs',  'ug',  'fa',  'tg',  'ml',  'tl',  'id',  'pt',  'ha',  'sw', 
Example Request
GET https://www.mp3quran.net/api/v3/recent_reads?language=eng
Example Response
                                {
{reads: [
{
id: 248,
name: "Issa Omar Sanankoua",
letter: "I",
recent_date: "2022-09-10T19:21:58.000000Z",
moshaf: [
{
id: 287,
moshaf_type: 116,
name: "Rewayat Hafs A'n Assem - Murattal",
server: "https://server16.mp3quran.net/i_Sanankoua/Rewayat-Hafs-A-n-Assem/",
surah_total: 26,
surah_list: "1,2,3,4,6,12,14,18,20,32,35,40,50,56,57,58,63,67,71,78,87,88,91,112,113,114"
}]},
{
id: 247,
name: "Abdulrahman Alshahhat",
letter: "A",
recent_date: "2022-09-02T17:28:53.000000Z",
moshaf: [
{
id: 286,
moshaf_type: 116,
name: "Rewayat Hafs A'n Assem - Murattal",
server: "https://server16.mp3quran.net/a_alshahhat/Rewayat-Hafs-A-n-Assem/",
surah_total: 114,
surah_list: "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39"
}]}}
                            
Overview
Get a list of all avalibale TV channels ( Makkah and Madinah).

عرض الروابط لبث قناة مكة و المدينة (مباشر )

Resource URL
https://mp3quran.net/api/v3/live-tv
Parameters
Name Required Description Default Value Example
language optional The language of texts in reads arrays. If is not set the default language of texts is arabic. 'ar', 'eng', 'fr', 'ru', 'de',  'es',  'tr',  'cn',  'th',  'ur',  'bn',  'bs',  'ug',  'fa',  'tg',  'ml',  'tl',  'id',  'pt',  'ha',  'sw', 
Example Request
GET https://mp3quran.net/api/v3/live-tv?language=eng
Example Response
                                
{{
livetv: [
{
id: 3,
name: "Quran channel",
url: "https://win.holol.com/live/quran/playlist.m3u8"
},
{
id: 4,
name: "Sunna channel",
url: "https://win.holol.com/live/sunnah/playlist.m3u8"
}]}]
}