Quran text, transliteration, and translations in JSON format.
Check out the /dist
to see all available JSON files. The JSON files are also available through JSDELIVR CDN.
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
- 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
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
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
If you want to generate the JSON files by yourself:
Clone this repository to your local computer:
$ git clone [email protected]:risan/quran-json.git
CD
into the project directory and install the dependencies:
# Go to the project directory
$ cd quran-json
# Install the dependencies
$ npm install
Run the following command to generate the JSON files:
$ npm run build
- 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.