Versioned Islamic data infrastructure for building reliable year-round products: Quran, Hadith, Hijri, and Prayer Times.
This API is a reusable backend for Islamic applications and research tools. It standardizes references, search, and date/prayer lookup.
| Dataset | Coverage | Rows | Primary Source |
|---|---|---|---|
| Quran | 114 Surahs, 6,236 Ayahs | 6,236 | AlQuran Cloud editions |
| Hadith | Arabic+English merged collections | 36,512 | Hadith API open corpus |
| Hijri | 1343-01-01 AH to 1500-12-30 AH | 55,991 | Umm al-Qura table |
| Prayer Times | All Nigeria entries + selected global cities | 836 | AlAdhan API snapshots |
pip install -r requirements.txt
python scripts/build_db.py
uvicorn app.main:app --host 127.0.0.1 --port 8000/v1| Domain | Endpoint | Purpose |
|---|---|---|
| Meta | GET /v1/health | Service health ping |
| Meta | GET /v1/meta | Counts and metadata |
| Quran | GET /v1/quran/ayah/{surah}/{ayah} | Direct ayah lookup |
| Quran | GET /v1/quran/search?q= | Full-text search |
| Hadith | GET /v1/hadith/{collection}/{hadith_number} | Canonical hadith lookup |
| Hadith | GET /v1/hadith/search?q= | Full-text search |
| Hijri | GET /v1/hijri/to-gregorian | Hijri to Gregorian |
| Hijri | GET /v1/hijri/from-gregorian | Gregorian to Hijri |
| Prayer | GET /v1/prayer/countries | Country list |
| Prayer | GET /v1/prayer/cities?country= | Cities by country |
| Prayer | GET /v1/prayer/times?country=&city= | Prayer times by location/date |
| Prayer | GET /v1/prayer/search-city?q= | City search helper |
GET /v1/quran/ayah/1/1
{"found":true,"data":{"surah_number":1,"ayah_number_in_surah":1}}GET /v1/hijri/from-gregorian?date=2026-04-29
{"found":true,"hijri_iso":"1447-11-12"}GET /v1/prayer/search-city?q=Lagos
{"query":"Lagos","count":2,"results":[{"city":"Lagos Island"}]}LICENSE in repository./v2).