JSON API
A free, static JSON API over the same Quran data this site renders. No key, no rate limit, no sign-up — it is flat files on a CDN. Attribution is required.
Endpoints
| Endpoint | Returns |
|---|---|
/api/index.json |
All 114 surahs and 30 juz with metadata |
/api/surah/{1–114}.json |
One surah: every verse in Arabic, its translation, and juz/page/ruku/sajda data |
/api/quran.json |
The whole Quran in one file (about 3 MB): every verse with Arabic, translation, page, juz, hizb, manzil, ruku and sajda |
/api/quran-metadata.csv |
Every verse's page, juz, hizb, hizb quarter, manzil, ruku, sajda and word and letter counts, as CSV, without the text (about 270 KB) |
/quran/{slug}/index.md |
The same surah as clean Markdown |
What a verse looks like
{
"number": 255,
"key": "2:255",
"arabic": "ٱللَّهُ لَآ إِلَٰهَ إِلَّا هُوَ ٱلْحَىُّ ٱلْقَيُّومُ …",
"translation": "Allah! There is no God save Him, the Alive, the Eternal. …",
"juz": 3, "page": 42, "ruku": 34, "hizbQuarter": 20
}Is there a Quran dataset with page numbers?
Yes. Both quran.json and
quran-metadata.csv give every verse its page in the
standard 604-page Madinah mushaf, alongside its juz, hizb (1–60) and hizb quarter (1–240), manzil
(1–7), ruku (1–556) and a flag on the 15 verses of prostration. The CSV adds each verse's word and
letter count, using the method stated on the statistics page.
Join the two on key (for example 2:255).
Can I download the whole Quran as JSON or CSV?
The JSON file holds the complete Arabic text and translation. The CSV deliberately holds only
positions and counts, with no text, so it carries no licensed content at all. For the text in
tabular form, take arabic and translation from the JSON.
How do I get a single verse?
Fetch its surah and select by number. There is no per-verse endpoint: a surah file
is small enough that one request is cheaper than many, and it keeps every verse in the context
that makes it quotable.
What are the terms?
The Arabic text is Tanzil Uthmani v1.1 under CC BY 3.0, and the translation is Pickthall, in
the public domain. Both require or expect attribution, so every response carries an
attribution object — reproduce it, or credit the sources named on the
credits page.
Is the data stable?
Yes. Surah numbers, verse numbers and slugs are permanent. The Quran text does not change, and URLs will not be repointed.