Awesome
<h1 align="center">Quran API</h1> <p align="center"> <img width="460" height="300" src="https://github.com/fawazahmed0/quran-api/raw/1/quran.jpg"> </p>In the name of God, who has guided me to do this work
This repo contains collection of Quran Translations and to allow development of websites, apps etc, it is structured in REST Architectural Style. The purpose of this repo is to spread the word of God everywhere in the world
Features:
- Free & Blazing Fast response
- No Rate limits
- 90+ languages & 440+ Translations including Latin/roman translations
URL Structure:
https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@{apiVersion}/{endpoint}
Formats:
The Endpoints Supports HTTP GET Method and returns the data in two formats:
/{endpoint}.json
/{endpoint}.min.json
The above formats also work for fallback i.e if .min.json
link fails, you can use .json
link and vice versa
Warning: You should include fallback mechanism in your code, to avoid issues
Endpoints:
/editions
<br>
Lists all the available editions in prettified json format:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions.json <br>
Get a minified version of it:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions.min.json
/editions/{editionName}
<br>
Get the whole quran/quran translation:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions/ben-muhiuddinkhan.json <br>
Get a latin(roman) script version of it by adding -la:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions/ben-muhiuddinkhan-la.json<br>
Get a latin(roman) script with diacritical marks by adding -lad:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions/ben-muhiuddinkhan-lad.json
/editions/{editionName}/{ChapterNo}
<br>
Get the whole chapter 5:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions/ben-muhiuddinkhan-la/5.json
Get the whole chapter 5 in minified format:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions/ben-muhiuddinkhan-la/5.min.json
/editions/{editionName}/{ChapterNo}/{VerseNo}
<br>
Get Chapter 5 verse 10:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions/ben-muhiuddinkhan-lad/5/10.json
/editions/{editionName}/juzs/{juzNo}
<br>
Get juz 3:<br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/editions/ben-muhiuddinkhan-lad/juzs/3.json
Similarly:
-
/editions/{editionName}/rukus/{rukuNo}
-
/editions/{editionName}/pages/{pageNo}
-
/editions/{editionName}/manzils/{manzilNo}
-
/editions/{editionName}/maqras/{maqraNo}
<br> -
/info
<br>
Get all the details about quran such as number of juzs,sajdas, rukus etc in quran <br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/info.json<br>
/fonts
<br>
Lists arabic fonts available: <br> https://cdn.jsdelivr.net/gh/fawazahmed0/quran-api@1/fonts.json<br>
Displaying Text:
-
Use Arabic Fonts to display the Quran text. In case the font shows few tofu characters, then use fonts with -full suffix which has complete Arabic Unicode Support.<br> Refer font-full to know more.
-
Use Google Noto Fonts to display the translation. By default OS doesn't have font installed for every language. So you will have to use fonts for few languages such as Burmese etc, to show properly. Otherwise you will end up with tofu characters.
Languages Available:
By the mercy of God, there are 98 different language translations available and a collection of 440+ translations. Few of the translations were OCRed and may contain mistakes. Please do report the mistakes.
Contribution:
Without your contribution, this repo won't survive, whenever you find any issue, don't just fix it at your end, please let me Know, so that I can also fix it and people can benefit from it, incase of any question, issue or problems etc<br> you can let me Know
- Please help by adding new translations to this repo, you can share me the translation here
or
- Read Contribute to add/update the translation directly to this repo
Download: Here
Authenticity:
I have taken care to not include any controversial authors, for example: 'Rashad Khalifa' , because there are chances that the translation may contain opinions of the author and not the meaning of the verse. The Ahmaddiya community has done great work in translating the quran to many different languages of the world. May God reward them with guidance. But I cannot take those translations also because the verses such as those talking about Jesus (4:157) usually have opinions of the author of what actually happened to Jesus etc.
I might have mistakenly added a few of them. In case you find any translation whose authenticity could be questioned, please let me know at here .After verifying the claims, I remove the translation
Any Issues: Raise here
Demo:
Projects using Quran API:
- Quran
- Quran Recitation Videos
- Quran Verse Detection
- Quran Hadith Search Engine
- Random Verse Generator
Other Similar Projects:
Share:
Please Share this repo with your fellow mates and Star this repo by clicking on :star: button above :arrow_upper_right:
Donation:
Even though I worked very hard on this project, I will not ask donation for myself. I will take the reward from God in this world and the next, may God accept my work.
But what I ask you is to donate directly to the authors and Islamic/dawah publishers who have worked so hard to make these translations, so that the word of God could spread around the world and people will know about the one who created them. Here is the Editions and References list, you might have to Google to get more details about them.
References:
All the open source projects and dawah/Islamic organizations
Please see Editions and References
<br> <br> <br>