Islamic AI API for Quran and Hadith search

Retrieve Quran, Hadith, Tafsir, and duas, then build source-backed AI answers with citations your users can inspect.

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
$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"
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": []
}
}