API › Reference

API reference

Everything starts at https://api.globalquran.com/v1. Two kinds of call: lists (what exists) and read (give me the text).

Your key
Send it as a header: X-API-Key: your key. Paste it here and the samples and Run buttons use it. It stays in your browser.
Get a key

Lists

What you can choose from.

Read

Give me this part, in this text. Add several texts with commas: en.sahih,ar.uthmani

Complete text

The whole Quran in one text. Best for apps that keep a copy.

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.
Errors
401 key missing or wrong403 key blocked404 unknown id429 slow down
The full OpenAPI file, for code generators and tools.
Download OpenAPI

GlobalQuran

Free to use. No ads, no tracking.