Madeenan Docs
Build Source-Backed Islamic Answers into Your App in Minutes
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 →JulAprMar
Islamic AI safety checklist
A practical checklist for teams building Islamic AI features with citations, source review, cautious copy, and human escalation.
How to add cited Islamic answers to an app
A practical product guide for adding Islamic AI answers with visible source trails, careful copy, and reviewable citations.
Madeenan vs raw Quran APIs
A practical comparison for teams deciding between raw Quran APIs and a source-backed Islamic AI layer with citations.