$curl -H "X-Madeenan-API-Key: mdeen_live_xxx" "https://api.madeenan.com/v1/search?q=patience&indexes=quran,hadith,tafsir,dua&limit_per_source=5"
Islamic source retrieval and citation API
Build Islamic apps with REST endpoints for source retrieval, grounded chat context, citations, and usage analytics.
ENDPOINT
Hybrid Search API
Query Qur'an, Hadith, Tafsir, and dua/adhkar sources simultaneously. Returns grouped source tabs with references, source text, translations, metadata, and relevance scores.
GET/v1/search
RESPONSE
Structured Payloads
Each result is structured for product UI: citation labels, Arabic text when available, translations, metadata, and score fields you can render or pass into your own workflows.
200 OKapplication/json
{
"results": {
"quran": [
{
"type": "quran_verse",
"ref": "Qur'an 2:153",
"arabic": "يَٰٓأَيُّهَا ٱلَّذِينَ ءَامَنُوا۟...",
"translation": "O you who have believed, seek help through patience...",
"score": 0.94
}
],
"hadith": [],
"tafsir": [],
"dua": []
}
}