Quran-api API

⭐ Beginner's Pick Books / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)

Overview

This community-maintained Quran API hosts the full Quran text in 90+ languages and 400+ translations as static JSON files on GitHub CDN—no rate limits, no key needed.

💡

Beginner Tip

Because it's static JSON, you can fetch individual chapter files like https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions/eng-translation/chapters/1.json. Using jsDelivr CDN keeps it fast worldwide.

Available Data

translated text
source language
target language
confidence score

Example Response

JSON Response
{
  "translatedText": "Bonjour le monde",
  "detectedSourceLanguage": "en",
  "targetLanguage": "fr"
}

Field Reference

chapter Array of verse objects for the requested chapter.
chapter[].verse Verse number within the chapter.
chapter[].translation Translated text of the verse in the requested language.

Implementation Example

const url = "https://github.com/fawazahmed0/quran-api";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

404 Not Found on chapter URL Wrong edition slug or chapter number out of range (1–114)
List available editions at https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions.json to find valid edition slugs.
Verse numbering mismatch between editions Different scholarly traditions number certain verses differently
Stick to one edition as the primary reference and map verse numbers explicitly if combining multiple editions.
Large payload slows page load Fetching a full chapter file when only a few verses are needed
Cache the chapter JSON locally on first fetch, then slice the verses array client-side instead of re-fetching each time.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 40ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS YES
Category Books
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →