quran-json

Quran text, transliteration, and translations in JSON format.

Usage no npm install needed!

<script type="module">
  import quranJson from 'https://cdn.skypack.dev/quran-json';
</script>

README

Quran JSON

Latest Version

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:

Get the List of Chapters

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/quran-json@3.1.2/dist/chapters/{chapterNumber}.json

# Quran text, transliteration, and translation:
https://cdn.jsdelivr.net/npm/quran-json@3.1.2/dist/chapters/{langCode}/{chapterNumber}.json

For example:

Get a Verse

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

https://cdn.jsdelivr.net/npm/quran-json@3.1.2/dist/verses/{verseNumber}.json

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

For example:

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 git@github.com: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