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
`/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
}

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.