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",
            "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
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
            "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
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"
            },
            {
                "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
GET 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 avalibale Moshaf for each language.

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

Resource URL
https://mp3quran.net/api/v3/moshaf
Parameters
Name Required Description Default Value Example
language optional The language of texts in moshaf 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/moshaf?language=ar
Example Response

    {
        "moshaf": [
            {
                "id": 116,
                "moshaf_type": 1,
                "moshaf_id": 16,
                "name": "حفص عن عاصم - مرتل"
            },
            {
                "id": 119,
                "moshaf_type": 1,
                "moshaf_id": 19,
                "name": "حفص عن عاصم - تلاوة مميزة"
            },
        ]
    }

                            
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
last_updated_date optional List will include only records added after this date
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 - 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
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,
                    "name": "Rewayat Hafs A'n Assem - Murattal",
                    "server": "https://server11.mp3quran.net/hazza/",
                    "surah_total": 75,
                    "moshaf_type": 116,
                    "surah_list": "1,13,14,15,18,19,25,29,30,31,36,37,38,39,40,42,44,47,49,50,51,52,53,54,55,56,57,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
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,
                    "name": "Rewayat Qalon A'n Nafi' - Murattal",
                    "server": "https://server16.mp3quran.net/deban/Rewayat-Qalon-A-n-Nafi/",
                    "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
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 - 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
GET 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
GET 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
GET 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
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', 
last_updated_date optional List will include only records added after this date
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 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
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"
        }
    ]
}

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