About
About Madeenan AI
Madeenan AI is a source-backed Islamic search and citation API for developers, with a free public library of Quran verses, reviewed hadith, duas, and topic pages. Every passage it shows carries its reference, so readers can open the source and check it.
Updated
What Is Madeenan AI?
Madeenan AI has two parts. The first is an API for developers: search across the Quran, Hadith, Tafsir, and duas, plus cited answer generation, returned as JSON with the reference, Arabic text, translation, and edition for each source. The developer docs and pricing describe how it works.
The second is a free public library built on the same sources: the Quran by surah and ayah, reviewed hadith, duas and adhkar, topic pages that gather sources on one theme, and a quote checker that shows where a saying's wording appears.
Retrieval quality is measured against a published 279-query baseline, with its limitations, in the search quality report.
Where Do the Sources Come From?
Madeenan imports publicly available datasets and keeps the edition and reference with every record. Counts below are from the published retrieval baseline.
- Quran · 6,236 ayahs
- Arabic in the Uthmani Hafs script, with the English translation by M. A. S. Abdel Haleem.
- Imported from fawazahmed0/quran-api
- Hadith · 34,455 reports
- Arabic and English editions of Sahih al-Bukhari, Sahih Muslim, Sunan Abu Dawud, Jami at-Tirmidhi, Sunan an-Nasa'i, and Sunan Ibn Majah, with the grade recorded in each edition where it has one.
- Imported from fawazahmed0/hadith-api
- Tafsir · 31,180 passages
- Tafsir Muyassar and Tafsir as-Sa'di in Arabic; Ibn Kathir, al-Jalalayn, and Ma'arif-ul-Quran in English.
- Imported from spa5k/tafsir_api
- Duas and Adhkar · 267 entries
- Hisn al-Muslim (Fortress of the Muslim), with Arabic, translation, transliteration, and repetition counts.
- Imported from wafaaelmaandy/Hisn-Muslim-Json
How Are Sources Reviewed?
Source text is shown as it appears in the edition named beside it. Madeenan does not write its own translations and does not grade hadith; a grade on the page is the one recorded in the collection, and gradings that name scholars are attributed to them.
Public hadith pages are limited to a reviewed list of reports, each checked against the Arabic and English text the API serves. Topic pages include a source only after its reference has been checked against that text, and the short notes beside each source explain why it is there. They are not commentary or rulings.
Pages that summarize what the collections contain about a circulating saying stay out of search indexes and sitemaps until they have been reviewed. A review by the site owner is not scholarly certification, and articles that make interpretive religious claims need qualified scholarly review before they are published.
Madeenan is not a fatwa service and does not replace qualified scholars. For questions of practice, or narrations that scholars grade differently, ask a scholar you trust.
How Do I Contact Madeenan?
Email [email protected] with questions about the API or the library, or to report a wrong reference, translation, or grade. Reported errors are checked against the source edition.
See also the privacy policy and terms of service.