Quran JSON

Quran text, transliteration, and translations in JSON format.

CDN

Check out the /dist to see all available JSON files. The JSON files are also available through JSDELIVR CDN.

Get The Entire Quran Text & Translations

This project is using the Uthmani Quran text from the The Noble Qur'an Encyclopedia. While the English transliteration is sourced from Tanzil.net. The translations are available in several languages:

• Quran text only: cdn.jsdelivr.net/npm/[email protected]/dist/quran.json
• Quran English transliteration: cdn.jsdelivr.net/npm/[email protected]/dist/quran_transliteration.json
• bn Bengali: cdn.jsdelivr.net/npm/[email protected]/dist/quran_bn.json
• zh Chinese: cdn.jsdelivr.net/npm/[email protected]/dist/quran_zh.json
• en English: cdn.jsdelivr.net/npm/[email protected]/dist/quran_en.json
• es Spanish: cdn.jsdelivr.net/npm/[email protected]/dist/quran_es.json
• fr French: cdn.jsdelivr.net/npm/[email protected]/dist/quran_fr.json
• id Indonesian: cdn.jsdelivr.net/npm/[email protected]/dist/quran_id.json
• ru Russian: cdn.jsdelivr.net/npm/[email protected]/dist/quran_ru.json
• sv Swedish: cdn.jsdelivr.net/npm/[email protected]/dist/quran_sv.json
• tr Turkish: cdn.jsdelivr.net/npm/[email protected]/dist/quran_tr.json
• ur Urdu: cdn.jsdelivr.net/npm/[email protected]/dist/quran_ur.json

Get the List of Chapters

• Arabic only: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/index.json
• Bengali: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/bn/index.json
• Chinese: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/zh/index.json
• English: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/en/index.json
• Spanish: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/es/index.json
• French: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/fr/index.json
• Indonesian: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/id/index.json
• Russian: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/ru/index.json
• Swedish: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/sv/index.json
• Turkish: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/tr/index.json
• Urdu: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/ur/index.json

Get a Chapter

You can get a single chapter (surah) by providing its chapterNumber (1-114). Both Quran text and its transliteration are provided on each chapter. To get the translation you can also provide the langCode:

# Quran text & transliteration:
https://cdn.jsdelivr.net/npm/[email protected]/dist/chapters/{chapterNumber}.json

# Quran text, transliteration, and translation:
https://cdn.jsdelivr.net/npm/[email protected]/dist/chapters/{langCode}/{chapterNumber}.json

For example:

• Al-Fatihah Quran text only: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/1.json
• Al-Rahman with English translation: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/en/55.json
• Al-Ikhlas with Indonesian translation: cdn.jsdelivr.net/npm/[email protected]/dist/chapters/id/112.json

Get a Verse

You can get a single verse (ayah) by providing its verseNumber (1-6236).

https://cdn.jsdelivr.net/npm/[email protected]/dist/verses/{verseNumber}.json

Unlike the rest of the JSON files, a single verse JSON file contains all available translations.

For example:

• Al-Fatihah verse #1: cdn.jsdelivr.net/npm/[email protected]/dist/verses/1.json
• An-Nas verse #6: cdn.jsdelivr.net/npm/[email protected]/dist/verses/6236.json

Generate the JSON

If you want to generate the JSON files by yourself:

1. Clone the Repository

Clone this repository to your local computer:

$ git clone [email protected]:risan/quran-json.git

2. Install the Dependencies

CD into the project directory and install the dependencies:

# Go to the project directory
$ cd quran-json

# Install the dependencies
$ npm install

3. Generate the JSON Files

Run the following command to generate the JSON files:

$ npm run build

Data Source

• The Uthmani Quran text is from The Noble Qur'an Encyclopedia.
• The English transliteration is from tanzil.net.
• The Bengali translation is authored by Muhiuddin Khan, and it's sourced from tanzil.net.
• The English translation is authored by Umm Muhammad (Saheeh International), and it's sourced from tanzil.net.
• The Spanish translation is authored by Muhammad Isa García, and it's sourced from tanzil.net.
• The French translation is authored by Muhammad Hamidullah, and it's sourced from tanzil.net.
• The Indonesian translation is authored by Indonesian Islamic Affairs Ministry, and it's sourced from The Noble Qur'an Encyclopedia.
• The Russian translation is authored by Elmir Kuliev, and it's sourced from tanzil.net.
• The Swedish translation is authored by Knut Bernström, and it's sourced from tanzil.net.
• The Turkish translation is authored by Turkish Directorate of Religious Affairs, and it's sourced from tanzil.net.
• The Urdu translation is authored by Abul A'la Maududi, and it's sourced from tanzil.net.
• The Chinese translation is authored by Muhammad Makin, and it's sourced from The Noble Qur'an Encyclopedia.

License

CC-BY-SA 4.0 · Risan Bagja Pradana