Quran JSON

Quick start

Fetch a chapter of Arabic text and a translation, then join them on verse id.

curl -s https://quran-json.risanb.com/text/uthmani/chapters/1.json
curl -s https://quran-json.risanb.com/translations/en-yusuf-ali/chapters/1.json

const get = (path) => fetch("https://quran-json.risanb.com" + path).then((r) => r.json());

const arabic = await get("/text/uthmani/chapters/1.json");
const english = await get("/translations/en-yusuf-ali/chapters/1.json");

// Both files number verses from 1: join on `id`.
const verses = arabic.verses.map((verse, i) => ({
  ...verse,
  translation: english.verses[i].translation,
}));

import requests

def get(path):
    return requests.get("https://quran-json.risanb.com" + path, timeout=30).json()

arabic = get("/text/uthmani/chapters/1.json")
english = get("/translations/en-yusuf-ali/chapters/1.json")

# Both files number verses from 1: join on `id`.
for verse, tr in zip(arabic["verses"], english["verses"]):
    print(verse["id"], verse["text"], tr["translation"])

Endpoints

All files are JSON, served from https://quran-json.risanb.com, with CORS open to any origin.

Scripts

Which script should I use?

• Most appsuthmani. Madinah mushaf style, Hafs reading.
• KFGQPC fontsqpc-hafs. KFGQPC encoding, for KFGQPC fonts.
• Search and matchingsimple-clean. No vowel marks.
• South Asiahafs-nastaliq or indopak. Nastaliq (KFGQPC) or Indo-Pak naskh (DigitalKhatt).
• Indonesiakemenag. Mushaf Standar Indonesia.
• North and West Africawarsh or qalun. Readings of Nafi.
• Sudanduri. al-Duri, reading of Abu Amr.

Page layouts such as the 13-, 15- and 16-line mushafs are not texts. Every script here is text; line breaks are yours to choose.

Translations are numbered like Hafs. Warsh, Qalun and al-Duri number verses their own way, so each of their verses carries number_in_hafs, the Hafs verse number or numbers it covers.

Translations

Transliteration

3 Latin-script renderings of the Hafs text. They follow the Hafs reading and numbering, so they are not offered for Warsh, Qalun or al-Duri.

machine-generated; not yet reviewed by a qualified reader

Audio

Audio is linked, not hosted. /audio/reciters.json lists 597 recordings with URL templates. Per-ayah files follow Hafs verse numbering, so they only fit Hafs scripts. Per-surah files play one whole chapter and need a recording of the same reading as the script.

Sources and licences

Dataset licence: CC BY-SA 4.0. Each source keeps its own terms. Detail per file is in /meta/sources.json.

Changes

• A published path is never renamed or removed.
• Content can be corrected when an upstream source corrects it. Text corrections are logged with evidence in /meta/qa.json; source versions are in/meta/sources.json. Do not assume the bytes at a URL never change.
• Removed in this release: /app/fonts.json, /assets/* (fonts moved to/fonts/*) and /app/*.js|css. They only served the old pages.
• The old dist/ files stay available from npm quran-json@3.1.2 and thev3.1.2 git tag.