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

newsletter

API Version 3