Al Quran Cloud API
Free Quran API with no key: Arabic text, translations in 40+ languages, verse-by-verse audio recitations and multiple editions. Tested curl example.
Endpoint tested and returned HTTP 200 on 2026-08-19
What is the Al Quran Cloud API?
The Al Quran Cloud API is a free, key-free API providing the complete Quran — Arabic text, translations in more than 40 languages, transliterations and verse-by-verse audio recitations from multiple reciters.
This API covers the Quran comprehensively: the Arabic text in several scripts, translations across dozens of languages, and audio recitations from many well-known reciters, all addressable by surah, ayah or juz.
Editions are the organising concept. Each combination of text, language and reciter is an edition identified by a code such as `en.asad` or `ar.alafasy`, so you request an ayah in whichever edition you need. Listing the editions endpoint first is the way to discover what is available.
Quick facts
- Base URL
https://api.alquran.cloud/v1- Authentication
- No API key required.
- Rate limit
- No published limit; fair use expected.
- Pricing
- Free.
- CORS
- Enabled — callable directly from browser JavaScript
- Official docs
- Read the docs
How to use the Al Quran Cloud API
Every request below was executed against the live API on 2026-08-19, and the response shown is the real body it returned — not an illustration.
1. Fetch a verse with translation
GET https://api.alquran.cloud/v1/ayah/262/en.asad
curl 'https://api.alquran.cloud/v1/ayah/262/en.asad'const res = await fetch("https://api.alquran.cloud/v1/ayah/262/en.asad");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);import requests
res = requests.get("https://api.alquran.cloud/v1/ayah/262/en.asad", timeout=20)
res.raise_for_status()
print(res.json()){
"code": 200,
"status": "OK",
"data": {
"number": 262,
"text": "GOD - there is no deity save Him, the Ever-Living, the Self-Subsistent Fount of All Being. Neither slumber overtakes Him, nor sleep. His is all that is in the heavens and all that is on earth. Who is there that could intercede with Him, unless it be by His leave? He knows all that lies open before men and all that is hidden from them, whereas they cannot attain to aught of His knowledge save that which He wills [them to attain]. His eternal power overspreads the heavens and the earth, and their upholding wearies Him not. And he alone is truly exalted, tremendous.",
"edition": {
"identifier": "en.asad",
"language": "en",
"name": "Asad",
"englishName": "Muhammad Asad",
"format": "text",
"type": "translation",
"direction": "ltr"
},
"surah": {
"number": 2,
"name": "سُورَةُ البَقَرَةِ",
"englishName": "Al-Baqara",
"englishNameTranslation": "The Cow",
"numberOfAyahs": 286,
"revelationType": "Medinan"
},
"numberInSurah": 255,
"juz": 3,
"manzil": 1,
"page": 42,
"ruku": 35,
"hizbQuarter": 17,
"sajda": false
}
}Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ayah/<reference>/<edition> | path | Optional | A single verse in a given edition. 262/en.asad |
surah/<number>/<edition> | path | Optional | A whole surah. 1/en.asad |
edition | path | Optional | List all available editions. edition |
juz/<number>/<edition> | path | Optional | A juz (para) of the Quran. 1/quran-uthmani |
Response fields
codeinteger- Status code inside the body.
statusstring- OK on success.
data.numberinteger- Global ayah number, 1 to 6236.
data.textstring- The verse text in the requested edition.
data.surahobject- Surah number, name in Arabic and English, and revelation type.
data.numberInSurahinteger- Verse position within its surah.
data.audiostring- Audio recitation URL when an audio edition is requested.
What you can build with the Al Quran Cloud API
- Build a Quran reading app with translations
- Add verse-by-verse audio recitation playback
- Create study tools comparing multiple translations
- Support Islamic educational resources
Common errors and how to fix them
404
Unknown edition code or out-of-range reference.
Fix: Fetch /edition first — codes follow a language.translator pattern such as en.asad.
Arabic renders incorrectly
Missing right-to-left handling or font support.
Fix: Set dir="rtl" and use a font with full Arabic script coverage.
No audio field
You requested a text edition.
Fix: Audio requires an audio edition such as ar.alafasy.
Al Quran Cloud API — frequently asked questions
Is the Quran API free?
Yes, completely free with no API key or registration.
What is an edition?
A specific text, translation or recitation identified by a code such as en.asad for Muhammad Asad's English translation or ar.alafasy for that reciter's audio. Request /edition to list them all.
Does it include audio recitations?
Yes, verse-by-verse audio from multiple reciters. Request an audio edition and the response includes an `audio` URL for each verse.
How many translations are available?
More than 40 languages, with multiple translators available for several of them, so you can compare renderings of the same verse.
Tools that pair with this API
Word Counter
Count words, characters, sentences, paragraphs and estimated reading time instantly. Free online word counter for essays, blogs and social media.
JSON Formatter
Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.
Al Quran Cloud is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-19; always check the official documentation before relying on this API in production, as terms and limits can change.