Quran API

How to Use This API

1. Get a Surah in Arabic

https://api.alquran.cloud/v1/surah/36

Surah numbers range from 1 (Al-Fatiha) to 114 (An-Nas). Returns all verses in Arabic.

2. Get Surah with Translation

https://api.alquran.cloud/v1/surah/36/en.asad

https://api.alquran.cloud/v1/surah/1/en.pickthall

Append the language and edition code to get translated text alongside Arabic.

3. Get a Single Verse (Ayah)

https://api.alquran.cloud/v1/ayah/262

https://api.alquran.cloud/v1/ayah/262/en.sahih

Verses use a global numbering system (1-6236). Ayah 1 is the Bismillah of Al-Fatiha.

4. Search the Quran

https://api.alquran.cloud/v1/search/mercy/en.asad

https://api.alquran.cloud/v1/search/forgiveness/en.pickthall

Full-text search across verses. Results include surah info, verse numbers, and matched text.

5. Get Audio Recitation

https://api.alquran.cloud/v1/surah/36/ar.abdulbasit

https://api.alquran.cloud/v1/surah/36/ar.ahmedajamy

Many reciters available. Each verse includes an audio URL and audioSecondary URL.

6. Get Multiple Editions at Once

https://api.alquran.cloud/v1/surah/1/editions/en.asad,en.pickthall,en.yusufali

Compare translations side by side using the editions endpoint.

7. Response Format

{
  "code": 200,
  "status": "OK",
  "data": {
    "number": 1,
    "name": "\u0633\u0648\u0631\u0629 \u0627\u0644\u0641\u0627\u062a\u062d\u0629",
    "englishName": "Al-Faatiha",
    "englishNameTranslation": "The Opening",
    "numberOfAyahs": 7,
    "ayahs": [
      {
        "number": 1,
        "text": "\u0628\u0650\u0633\u0652\u0645\u0650...",
        "numberInSurah": 1,
        "juz": 1,
        "manzil": 1,
        "page": 1,
        "ruku": 1,
        "hizbQuarter": 1,
        "sajda": false
      }
    ],
    "edition": {
      "identifier": "quran-uthmani",
      "language": "ar",
      "name": "Uthmani",
      "type": "quran"
    }
  }
}

8. JavaScript — Fetch Surah with Translation

fetch('https://api.alquran.cloud/v1/surah/1/en.asad')
  .then(r => r.json())
  .then(d => {
    const surah = d.data;
    console.log(`Surah ${surah.number}: ${surah.englishName}`);
    console.log(`Translation: ${surah.englishNameTranslation}`);
    surah.ayahs.forEach(a => {
      console.log(`[${a.numberInSurah}] ${a.text}`);
    });
  });

9. Python — Search and Display

import requests

resp = requests.get('https://api.alquran.cloud/v1/search/mercy/en.asad')
results = resp.json()['data']['matches']
print(f"Found {len(results)} verses containing 'mercy':")
for match in results[:5]:
    print(f"  [{match['surah']['number']}:{match['numberInSurah']}] {match['text']}")

10. Python — Compare Translations

import requests

resp = requests.get(
    'https://api.alquran.cloud/v1/ayah/1/editions/en.asad,en.pickthall,en.yusufali'
)
data = resp.json()['data']
for edition in data:
    print(f"{edition['edition']['name']}: {edition['text']}")