Docs › How it works
Docs · the one page to read first

How everything fits together

The API, the data files, the audio and the embed all use the same three ideas. Learn them once and the rest is easy.

1 · Quran ID
en.sahih
Names one text: language code + author. Arabic texts have their own IDs, like quran-uthmani.
2 · Reciter ID
ar.abdulbasitmurattal
Names one reciter, same pattern. Each has formats, bit rates and a mode.
3 · Ayah number
262 = 2:255
Every ayah has a global number 1 to 6,236. Surah:ayah is the same thing in two parts.

Try it: pick any ayah

Surah
Ayah (1 to 286)
Loading the surah list…
Where do I find the IDs?
Three lists, always current.
GET /v2/list/translation GET /v2/list/recitor GET /v2/list/quran
Which ayah is which number?
The surah list gives where each surah starts and ends.
GET /v1/surah # surah 2: start_ayah 8, end_ayah 293

Which door should I use?

I want to…UseKey?
Show a Quran reader on a web pageEmbedNo
Build my own app or look up versesAPIFree key
Have everything offline or in my databaseDataNo
Play recitationsAudio (link the CDN)No
Let an AI assistant write it for meAI instructionsSame as API

GlobalQuran

Free to use. No ads, no tracking.