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 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
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

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.