BYTETOOLS

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.

No API key requiredCORS enabledHTTPSFree tier

Endpoint tested and returned HTTP 200 on 19 Aug 2026

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 19 Aug 2026, 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
curl 'https://api.alquran.cloud/v1/ayah/262/en.asad'
JavaScript (fetch)
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);
Python (requests)
import requests

res = requests.get("https://api.alquran.cloud/v1/ayah/262/en.asad", timeout=20)
res.raise_for_status()
print(res.json())
Response — HTTP 200
{
  "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

ParameterTypeRequiredDescription
ayah/<reference>/<edition>pathOptionalA single verse in a given edition. 262/en.asad
surah/<number>/<edition>pathOptionalA whole surah. 1/en.asad
editionpathOptionalList all available editions. edition
juz/<number>/<edition>pathOptionalA 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

Alternatives to Al Quran Cloud API

If Al Quran Cloud does not fit, these book & dictionary apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

APIWhat it doesAuthCORSLast verified
Free Dictionary APIFree dictionary API with no key: definitions, phonetics, audio pronunciation, synonyms, antonyms and examples for English words. Tested curl example.No keyYes19 Aug 2026
DatamuseFree word-finding API with no key: rhymes, synonyms, antonyms, related words, spelling suggestions and autocomplete. 100k requests/day. Tested example.No keyYes19 Aug 2026
Open LibraryFree book API from the Internet Archive: search by ISBN, title or author, with covers, publication data and subjects. No key required. Tested curl example.No keyYes19 Aug 2026
PoetryDBFree poetry API with no key: full poem text by author, title or line count from a public-domain corpus. CORS enabled. Tested curl example and live JSON.No keyYes19 Aug 2026
Quran.com APIFree Quran API with no key: all 114 chapters with Arabic and transliterated names, revelation order and place, verse counts and page ranges. Tested example included.No keyYes21 Aug 2026
SefariaFree Sefaria API with no key: Hebrew and English texts of the Tanakh, Talmud, Mishnah and commentaries, with version metadata, licensing and interlinked references. Tested example included.No keyYes21 Aug 2026
All Book & Dictionary APIs

Al Quran Cloud is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 19 Aug 2026; always check the official documentation before relying on this API in production, as terms and limits can change.