quran-json
v3.1.2
Published
Quran text, transliteration, and translations in JSON format.
Downloads
1,325
Readme
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.