Rate limits
Free tier intended for personal and small applications. A higher tier with an API key for production use, with the limit published.
AQLC / About / Open API
Open Islamic API
Structured Qur'an, hadith, du'a, prayer time and calendar data over a documented HTTP API, so developers can build Islamic tools on verified content.
Endpoints
Planned surface
| Method | Endpoint | Returns |
|---|---|---|
| GET | /v1/quran/surahs | All 114 surahs with metadata |
| GET | /v1/quran/{surah} | Verses with Arabic, translation, transliteration |
| GET | /v1/quran/{surah}/{ayah} | A single verse with audio reference |
| GET | /v1/hadith/collections | Collections with section structure |
| GET | /v1/hadith/{collection}/{number} | A narration with its reference |
| GET | /v1/duas | Du'as by occasion and source |
| GET | /v1/prayer-times | Timings by coordinates |
| GET | /v1/calendar/{year} | Hijri dates and significant days |
Example
A verse, as JSON
GET /v1/quran/2/255
{
"surah": 2,
"ayah": 255,
"surah_name": "Al-Baqara",
"arabic": "…",
"translation": {
"edition": "en.sahih",
"text": "Allah - there is no deity except Him…"
},
"transliteration": "…",
"audio": "…/ar.alafasy/262.mp3",
"juz": 3,
"page": 42,
"source": "quran-uthmani"
}Every response carries its source identifier, so a client can display where the data came from.
Terms
Attribution required for every use. No modification of Qur'anic text or hadith translations. No use in a product that claims to issue fatwas automatically.
Ecosystem
Widgets for other Islamic websites: ayah of the day, prayer times, hadith of the day and a Qur'an player, each rendering with its source visible.
Planned, not deployed.
This page documents the intended API surface. No endpoint on this page is live. Before publishing an API that returns religious text, decide the source editions you will serve, how you will version a correction, and how a downstream consumer will see that a hadith grading was revised.
This page documents the intended API surface. No endpoint on this page is live. Before publishing an API that returns religious text, decide the source editions you will serve, how you will version a correction, and how a downstream consumer will see that a hadith grading was revised.