Get a list of all avalibale languages, with all sura,rewayah and reciters for each language
يمكنك هنا استعراض جميع اللغات المتاحة مع عرض لروابط السور والروايات و القراء لكل لغة
za programere
Developer documentation
Overview
Resource URL
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",
"rewayah": "https://www.mp3quran.net/api/v3/moshaf?language=ar",
"reciters": "https://www.mp3quran.net/api/v3/reciters?language=ar",
"radios": "https://www.mp3quran.net/api/v3/radios?language=ar",
"tafasir": "https://www.mp3quran.net/api/v3/tafasir?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",
"rewayah": "https://www.mp3quran.net/api/v3/moshaf?language=eng",
"reciters": "https://www.mp3quran.net/api/v3/reciters?language=eng",
"radios": "https://www.mp3quran.net/api/v3/radios?language=eng",
"tafasir": "https://www.mp3quran.net/api/v3/tafasir?language=eng"
}
]
}
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
https://mp3quran.net/api/v3/suwar?language=eng
Example Response
{
"suwar": [
{
"id": 1,
"name": "Al-Fatihah ",
"start_page": 1,
"end_page": 1,
"makkia": 1
"type": 0
},
{
"id": 2,
"name": "Al-Baqarah ",
"start_page": 2,
"end_page": 49,
"makkia": 0
"type": 1
},
{
"id": 3,
"name": "Al-Imran ",
"start_page": 50,
"end_page": 76,
"makkia": 0
"type": 1
}
]
}
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
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"
},
{
"id": 12,
"name": "Rewayat AlDorai A'n Al-Kisa'ai"
}
]
}
Overview
Get a list of all avalibale video types for each language.
يمكنك هنا استعراض تصنيفات الفيديو لكل لغة
Resource URL
https://mp3quran.net/api/v3/video_types
Parameters
| Name | Required | Description | Default Value | Example |
|---|---|---|---|---|
| language | optional | The language of texts in video_types 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
https://mp3quran.net/api/v3/video_types?language=eng
Example Response
{
"video_types": [
{
"id": 2,
"video_type": "الصلاة على النبي صلى الله عليه وسلم"
},
{
"id": 3,
"video_type": "نفحات إيمانية"
},
{
"id": 4,
"video_type": "نفحات رمضانية"
},
]
}
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.
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 | ||
| last_updated_date | optional | List will include only records added after this date |
Example Request
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 - Murattal",
"server": "https://server6.mp3quran.net/akdr/",
"surah_total": 114,
"moshaf_type": 116,
"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,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114"
}
]
}
]
}
Example Request
https://www.mp3quran.net/api/v3/reciters?language=eng&reciter=231
Example Response
{
"reciters": [
{
"id": 231,
"name": "Hazza Al-Balushi",
"letter": "H",
"date": "2025-09-14T04:55:55.000000Z",
"moshaf": [
{
"id": 231,
"name": "Rewayat Hafs A'n Assem - Murattal",
"server": "https://server11.mp3quran.net/hazza/",
"surah_total": 83,
"moshaf_type": 11,
"surah_list": "1,6,13,14,15,18,19,20,25,29,30,31,32,34,35,36,37,38,39,40,41,42,44,47,49,50,51,52,53,54,55,56,57,61,63,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114"
}
]
}
]
}
Example Request
https://www.mp3quran.net/api/v3/reciters?language=eng&reciter=265&rewaya=5
Example Response
{
"reciters": [
{
"id": 265,
"name": "Ahmad Deban",
"letter": "A",
"date": "2025-08-30T21:47:54.000000Z",
"moshaf": [
{
"id": 280,
"name": "Rewayat Qalon A'n Nafi' - Murattal",
"server": "https://server16.mp3quran.net/deban/Rewayat-Qalon-A-n-Nafi/",
"surah_total": 114,
"moshaf_type": 51,
"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,40,"
}
]
}
]
}
Example Request
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 - Murattal",
"server": "https://server6.mp3quran.net/akdr/",
"surah_total": 114,
"moshaf_type": 116,
"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,40,"
}
]
}
]
}
Example Request
https://www.mp3quran.net/api/v3/reciters?language=eng&sura=18
Example Response
{
"reciters": [
{
"id": 1,
"name": "Ibrahim Al-Akdar",
"letter": "I",
"moshaf": [
{
"id": 1,
"name": "Rewayat Hafs A'n Assem - Murattal",
"server": "https://server6.mp3quran.net/akdr/",
"surah_total": 114,
"moshaf_type": 116,
"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,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114"
}
]
}
]
}
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
https://www.mp3quran.net/api/v3/recent_reads?language=eng
Example Response
{
"reads": [
{
"id": 191,
"name": "Ahmad Al Nufais",
"letter": "A",
"recent_date": "2023-01-30T15:24:51.000000Z",
"moshaf": [
{
"id": 211,
"name": "Rewayat Hafs A'n Assem - Murattal",
"server": "https://server16.mp3quran.net/nufais/Rewayat-Hafs-A-n-Assem/",
"surah_total": 114,
"moshaf_type": 116,
"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,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114"
}
]
}
]
}
Overview
Get a list of all avalibale videos ordered by added date.
يمكنك هنا استعراض الفيديوهات بحسب تاريخ الإضافة ، ( الأحدث أولا)
Resource URL
https://mp3quran.net/api/v3/videos
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
https://www.mp3quran.net/api/v3/videos?language=ar
Example Response
{
"videos": [
{
"id": 93,
"reciter_name": "ماهر المعيقلي",
"videos": [
{
"id": 15,
"video_type": 2,
"video_url": "https://www.mp3quran.net/uploads/videos/group1_pbuh/maher.mp4",
"video_thumb_url": "http://mp3quran.de/uploads/videos/md/maher-2.jpeg",
}
]
}
]
}
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
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', | |
| last_updated_date | optional | List will include only records added after this date |
Example Request
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
https://mp3quran.net/api/v3/tafasir?language=ar
Example Response
{
"tafasir": [
{
"id": 1,
"url": "https://www.mp3quran.net/api/v3/tafsir?tafsir=1&language=ar",
"name": "الخلاصة من تفسير الطبري"
}
]
}
Overview
Get a list of all soar of Tafsir.
عرض الروابط سور التفسير
Resource URL
https://mp3quran.net/api/v3/tafsir
Parameters
| Name | Required | Description | Default Value | 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
https://www.mp3quran.net/api/v3/tafsir?tafsir=1&sura=114&language=ar
Example Response
{
tafasir: :
{
name: الخلاصة من تفسير الطبري,
sora: { 114: [{": ,
id:: 114,
tafsir_id: 1,
name: "سورة الناس كاملة",
url: "https://server17.mp3quran.net/tafseer/tabri/114.mp3",
sura_id:: 114
}
]
}}}
Overview
Get a list of all tadabors.
عرض الوقفات التدبرية
Resource URL
https://mp3quran.net/api/v3/tadabor
Parameters
| Name | Required | Description | Default Value | Example |
|---|---|---|---|---|
| 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
https://mp3quran.net/api/v3/tadabor?sura=3&language=ar
Example Response
{
"tadabor": {
"1": [
{
"id": 38,
"audio_url": "https://server18.mp3quran.net/tadabor/audio/0038.mp3",
"image_url": "https://server18.mp3quran.net/tadabor/image/0038.jpg",
"text": "الحذر من اتباع منهج اليهود : (تقديم الهوى على الشرع) ، "غَیۡرِ ٱلۡمَغۡضُوبِ عَلَیۡهِمۡ" . ومن اتباع منهج النصارى : (العبادة بالبدعة والجهل) ، "وَلَا ٱلضَّاۤلِّینَ" .",
"sora_name": "الفاتحة\r\n",
"rewaya_name": "حفص عن عاصم",
"reciter_name": "محمد البراك"
}
]
}
}
Overview
Get a list of ayat timing for specific read and surah.
عرض اوقات بداية و نهاية الايات لكل سورة من قرائة
Resource URL
https://mp3quran.net/api/v3/ayat_timing
Old Resource URL (Deprecate)
https://mp3quran.net/api/ayat_timing
Parameters
| Name | Required | Description | Default Value | Example |
|---|---|---|---|---|
| surah | Required | Surah number | 1,2,3,... | |
| read | Required | Read Id | 1,2,3,... |
Example Request
https://mp3quran.net/api/v3/ayat_timing?surah=2&read=5
Example Response
[
{
"ayah": 0,
"polygon": null,
"start_time": 0,
"end_time": 5587,
"x": null,
"y": null,
"page": null
},
{
"ayah": 1,
"polygon": "206.48,46.08 172.36,46.08 172.36,72.23 206.48,72.23",
"start_time": 5587,
"end_time": 12658,
"x": "178.34",
"y": "63.11",
"page": "https://www.mp3quran.net/api/quran_pages_svg/002.svg"
}
]
Overview
Get a list of reads that has timing.
عرض القراءات التي لها توقيت
Resource URL
https://mp3quran.net/api/v3/ayat_timing/reads
Old Resource URL (Deprecate)
https://mp3quran.net/api/ayat_timing/reads
Example Request
https://mp3quran.net/api/v3/ayat_timing/reads
Example Response
[
{
"id": 5,
"name": "أحمد بن علي العجمي",
"rewaya": "حفص عن عاصم",
"folder_url": "https://server10.mp3quran.net/ajm/",
"soar_count": 114,
"soar_link": "http://mp3quran.de/api/v3/ayat_timing/soar?read=5"
}
]
Overview
Get a list of Suar of given read.
عرض قائمة السور قراءة محددة
Resource URL
https://mp3quran.net/api/v3/ayat_timing/soar
Old Resource URL (Deprecate)
https://mp3quran.net/api/ayat_timing/soar
Parameters
| Name | Required | Description | Default Value | Example |
|---|---|---|---|---|
| read | Required | Read Id | 1,2,3,... |
Example Request
https://mp3quran.net/api/v3/ayat_timing/soar?read=5
Example Response
[
{
"id": 1,
"name": "الفاتحة\r\n",
"timing_link": "http://mp3quran.de/api/v3/ayat_timing?surah=1&read=5"
},
{
"id": 2,
"name": "البقرة\r\n",
"timing_link": "http://mp3quran.de/api/v3/ayat_timing?surah=2&read=5"
}
]