Madeenan Docs
Build Source-Backed Islamic Answers into Your App
Madeenan retrieves Qur'an, Hadith, Tafsir, and dua sources, then returns citation payloads your product can inspect and render.
$curl https://api.madeenan.com/v1/chat \
-H "X-Madeenan-API-Key: mdeen_live_..." \
-H "Content-Type: application/json" \
-d '{
"message": "Explain Ayat al-Kursi with sources"
}'
{
"answer": "Ayat al-Kursi describes Allah's absolute life, knowledge, authority, and care over creation. It says that neither drowsiness nor sleep overtakes Him, and that His knowledge surrounds what is before and behind people.",
"citations": [
{
"source_id": "quran_2_255",
"type": "quran",
"citation_label": "Qur'an 2:255",
"title": "Ayat al-Kursi",
"arabic": "اللَّهُ لَا إِلَٰهَ إِلَّا هُوَ الْحَيُّ الْقَيُّومُ...",
"translation": "Allah - there is no deity except Him, the Ever-Living, the Sustainer of existence..."
}
],
"provider": "gemini",
"model": "gemini-2.5-flash-lite"
}
Source note
Madeenan does not replace scholarship. It helps apps retrieve, cite, and present Islamic sources responsibly.
Writing
All Posts →JulJulJul
When Patience Does Not Feel Peaceful
A personal reflection on the distance between speaking about patience and trying to live it while the ending remains unknown.
The Hadith We Quote Before We Read
What changes when ‘actions are by intentions’ returns to its collection, report number, longer context, and proper source trail.
Words for When Your Own Words Disappear
A personal, source-led reflection on reaching for a reported dua when anxiety and sorrow make ordinary language difficult.