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	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"
}]}]
}

Overview

Get a list of all avalibale Radios.

عرض الروابط للإداعات

Resource URL

https://mp3quran.net/api/v3/radios

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/radios?language=eng

Example Response

                                
{
    "radios": [
        {
        "id": 10,
        "name": "Radio Alzain Mohammad Ahmad",
        "url": "https://Qurango.net/radio/alzain_mohammad_ahmad"
        },
        {
        "id": 100,
        "name": "Radio Ahmad Khader Al-Tarabulsi",
        "url": "https://Qurango.net/radio/ahmad_khader_altarabulsi"
        }
        ...
    ]
}

Overview

Get a list of all avalibale Tafasirs.

عرض الروابط التفاسير

Resource URL

https://mp3quran.net/api/v3/tafasir

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/tafasir?language=eng

Example Response

                                
{
    "tafasir": [
        {
            "id": 4,
            "name": "tafsir 1",
            "url": "https://mp3quran.net/api/v3/tafsir?tafsir=4&language=ar"
        },
        {
            "id": 5,
            "name": "tafsir 2",
            "url": "https://mp3quran.net/api/v3/tafsir?tafsir=5&language=ar"
        }
    ]
}

Overview

Get a list of all soar of Tafsir.

عرض الروابط سور التفسير

Resource URL

https://mp3quran.net/api/v3/tafsir

Parameters

Name	Required	Description	Example
tafsir	required	tafsir id	5
sura	optional	sura number to filter by	1,2,3,...
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/tafsir?tafsir=5&sura=3&language=ar

Example Response

                                
{
    "tafasir": [
        {
            "id": 16,
            "tafsir_id": 5,
            "name": "سورة آل عمران كاملة",
            "tafsir_name": "tafsir 2"
        }
    ]
}

newsletter

API Version 3