API reference
Everything starts at https://api.globalquran.com/v1. Two kinds of call: lists (what exists) and read (give me the text).
Lists
What you can choose from.
Read
Give me this part, in this text. Add several texts with commas: en.sahih,ar.uthmani
| GET | /v1/ayah/{ayah}/{quranId} | One ayah | Details → |
| GET | /v1/surah/{surah}/{quranId} | One surah | Details → |
| GET | /v1/page/{page}/{quranId} | One page | Details → |
| GET | /v1/juz/{juz}/{quranId} | One juz | Details → |
Complete text
The whole Quran in one text. Best for apps that keep a copy.
| GET | /v1/complete/{quranId} | Complete text | Details → |
| GET | /v1/all/{type}/{number}/{quranId}/{lang} | Everything in one request | Details → |
Audio
The API tells you which reciters exist. The audio itself is plain files on our CDN (no key): you build the address from the reciter, the format and the ayah or surah number. The Audio page explains it step by step and lets you play.
| GET | /v2/list/recitor | List reciters | Details → |
| FILE | https://audio.globalquran.com/{reciter}/{format}/{kbs}kbs/{ayah}.mp3 | Audio file, verse by verse | Details → |
| FILE | https://audio.globalquran.com/{reciter}/{format}/{kbs}kbs/surah/{surah}.mp3 | Audio file, surah by surah | Details → |
Errors
401 key missing or wrong403 key blocked404 unknown id429 slow down