Quran Tafseer

This is an REST APIs fro Quran Tafseer or Translation, it's a place you'll find most of Quran Tafseer, and it's free to use.

Chapter List Endpoint

Description

Simple API endpoint to get a list of Quran chapters, the index can be use in other endpoints.

Request

HTTP Method
GET
URL
api.quran-tafseer.com/quran
URL Parameters
None

Response

Status Codes
  • 200 OK: Returned list of Quran's chapters
Body 
                        
[
    {
        "index": 1,
        "name": "الفاتحة"
    },
    {
        "index": 2,
        "name": "البقرة"
    },
    {
        "index": 3,
        "name": "آل عمران"
    },
    ...
]

Verse Details Endpoint

Description

API endpoint to get a text for specific Verse in Sura, you should pass Sura number and Ayah number as URL path parameter.

Request

HTTP Method
GET
URL
api.quran-tafseer.com/quran/{sura_number}/{ayah_number}
URL Parameters
  • sura_number: Chapter Number
  • ayah_number: Verse Number

Response

Status Codes
  • 200 OK: Returned details of Qura'sn verse
  • 404 Not Found: Can't found verse with supplied sura_number and ayah_number
Body 
                    
{
    "sura_index": 1,
    "sura_name": "الفاتحة",
    "ayah_number": 1,
    "text": "بِسْمِ اللَّهِ الرَّحْمَنِ الرَّحِيمِ"
}

Tafseer List Endpoint

Description

Simple API endpoint to get a list of Quran tafseer available in Tafseer API, the id can be use in other endpoints.

Request

HTTP Method
GET
URL
api.quran-tafseer.com/tafseer
URL Parameters
None

Response

Status Codes
  • 200 OK: Returned list of Quran's tafseers
Body 
                    
[
    {
        "id": 1,
        "name": "التفسير الميسر",
        "language": "ar",
        "author": "نخبة من العلماء",
        "book_name": "التفسير الميسر"
    },
    {
        "id": 2,
        "name": "تفسير الجلالين",
        "language": "ar",
        "author": "جلال الدين المحلي و السيوطي",
        "book_name": "تفسير الجلالين"
    },
    ...
]

Verse Tafseer Endpoint

Description

API endpoint to get a specific tasfeer for verse in chapter, you should pass Tafseer Id which can get from Tafseer List Endpoint, Sura number, and Ayah number as URL path parameter.

Request

HTTP Method
GET
URL
api.quran-tafseer.com/tafseer/{tafseer_id}/{sura_number}/{ayah_number}
URL Parameters
  • tafseer_id: Tafseer Id
  • sura_number: Chapter Number
  • ayah_number: Verse Number

Response

Status Codes
  • 200 OK: Returned list of Quran verse's tafseer
  • 404 NOT FOUND: Can't find tafseer with id supplied or with chapter number and verse number
Body 
                    
{
    "tafseer_id": 1,
    "tafseer_name": "التفسير الميسر",
    "ayah_url": "/quran/2/1",
    "ayah_number": 8,
    "text": "هذه الحروف وغيرها من الحروف المقطَّعة في أوائل السور فيها إشارة إلى إعجاز القرآن؛ فقد وقع به تحدي المشركين، فعجزوا عن معارضته، وهو مركَّب من هذه الحروف التي تتكون منها لغة العرب. فدَلَّ عجز العرب عن الإتيان بمثله -مع أنهم أفصح الناس- على أن القرآن وحي من الله."
}

Verse Tafseer Range Endpoint

Description

API endpoint to get a specific tasfeer for range of verses in a chapter, you should pass Tafseer Id which can get from Tafseer List Endpoint, Sura number, Ayah number from, and Ayah number to as URL path parameter.

Request

HTTP Method
GET
URL
api.quran-tafseer.com/tafseer/{tafseer_id}/{sura_number}/{ayah_number_from}/{ayah_number_to}
URL Parameters
  • tafseer_id: Tafseer Id
  • sura_number: Chapter Number
  • ayah_number_from: Start Verse Number Range
  • ayah_number_to: End Verse Number Range

Response

Status Codes
  • 200 OK: Returned list of Quran's verses tafseer according to the range
  • 404 NOT FOUND:
    • Can't find tafseer with id supplied or with chapter number and verse number range.
    • Wrong Verse numbers range (Replace start index with the end index).
Body 
                    
[
    {
        "tafseer_id": 1,
        "tafseer_name": "التفسير الميسر",
        "ayah_url": "/quran/1/1",
        "ayah_number": 1,
        "text": "سورة الفاتحة سميت هذه السورة بالفاتحة؛ لأنه يفتتح بها القرآن العظيم، وتسمى المثاني؛ لأنها تقرأ في كل ركعة، ولها أسماء أخر. أبتدئ قراءة القرآن باسم الله مستعينا به، (اللهِ) علم على الرب -تبارك وتعالى- المعبود بحق دون سواه، وهو أخص أسماء الله تعالى، ولا يسمى به غيره سبحانه. (الرَّحْمَنِ) ذي الرحمة العامة الذي وسعت رحمته جميع الخلق، (الرَّحِيمِ) بالمؤمنين، وهما اسمان من أسمائه تعالى، يتضمنان إثبات صفة الرحمة لله تعالى كما يليق بجلاله."
    },
    {
        "tafseer_id": 1,
        "tafseer_name": "التفسير الميسر",
        "ayah_url": "/quran/1/2",
        "ayah_number": 2,
        "text": "(الحَمْدُ للهِ رَبِّ العَالَمِينَ) الثناء على الله بصفاته التي كلُّها أوصاف كمال، وبنعمه الظاهرة والباطنة، الدينية والدنيوية، وفي ضمنه أَمْرٌ لعباده أن يحمدوه، فهو المستحق له وحده، وهو سبحانه المنشئ للخلق، القائم بأمورهم، المربي لجميع خلقه بنعمه، ولأوليائه بالإيمان والعمل الصالح."
    },
    {
        "tafseer_id": 1,
        "tafseer_name": "التفسير الميسر",
        "ayah_url": "/quran/1/3",
        "ayah_number": 3,
        "text": "(الرَّحْمَنِ) الذي وسعت رحمته جميع الخلق، (الرَّحِيمِ)، بالمؤمنين، وهما اسمان من أسماء الله تعالى."
    },
    {
        "tafseer_id": 1,
        "tafseer_name": "التفسير الميسر",
        "ayah_url": "/quran/1/4",
        "ayah_number": 4,
        "text": "وهو سبحانه وحده مالك يوم القيامة، وهو يوم الجزاء على الأعمال. وفي قراءة المسلم لهذه الآية في كل ركعة من صلواته تذكير له باليوم الآخر، وحثٌّ له على الاستعداد بالعمل الصالح، والكف عن المعاصي والسيئات."
    },
    {
        "tafseer_id": 1,
        "tafseer_name": "التفسير الميسر",
        "ayah_url": "/quran/1/5",
        "ayah_number": 5,
        "text": "إنا نخصك وحدك بالعبادة، ونستعين بك وحدك في جميع أمورنا، فالأمر كله بيدك، لا يملك منه أحد مثقال ذرة. وفي هذه الآية دليل على أن العبد لا يجوز له أن يصرف شيئًا من أنواع العبادة كالدعاء والاستغاثة والذبح والطواف إلا لله وحده، وفيها شفاء القلوب من داء التعلق بغير الله، ومن أمراض الرياء والعجب، والكبرياء."
    },
    {
        "tafseer_id": 1,
        "tafseer_name": "التفسير الميسر",
        "ayah_url": "/quran/1/6",
        "ayah_number": 6,
        "text": "دُلَّنا، وأرشدنا، ووفقنا إلى الطريق المستقيم، وثبتنا عليه حتى نلقاك، وهو الإسلام، الذي هو الطريق الواضح الموصل إلى رضوان الله وإلى جنته، الذي دلّ عليه خاتم رسله وأنبيائه محمد صلى الله عليه وسلم، فلا سبيل إلى سعادة العبد إلا بالاستقامة عليه."
    }
]