{"id":13620373,"url":"https://github.com/gadingnst/quran-api","last_synced_at":"2025-05-16T18:06:44.334Z","repository":{"id":37486304,"uuid":"252468317","full_name":"gadingnst/quran-api","owner":"gadingnst","description":"Simple Quran API \u0026 Database with Indonesia Tafsir and media audio (murrotal) Syekh. Mishary Rashid Alafasy","archived":false,"fork":false,"pushed_at":"2023-12-20T16:02:18.000Z","size":8002,"stargazers_count":785,"open_issues_count":14,"forks_count":219,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-05-16T18:06:39.420Z","etag":null,"topics":["al-quran","alquran","alquran-web","hacktoberfest","hacktoberfest2022","indonesia-tafsir","islamic","islamic-works","quran","quran-api","quran-audio","quran-database","quran-json","quran-online","quran-translation","quran-transliteration","quran-web","rest-api","tafsir-surahs","verses"],"latest_commit_sha":null,"homepage":"https://api.quran.gading.dev","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gadingnst.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-04-02T13:48:51.000Z","updated_at":"2025-05-12T21:53:52.000Z","dependencies_parsed_at":"2024-01-11T13:20:07.821Z","dependency_job_id":null,"html_url":"https://github.com/gadingnst/quran-api","commit_stats":null,"previous_names":["sutanlab/quran-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadingnst%2Fquran-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadingnst%2Fquran-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadingnst%2Fquran-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gadingnst%2Fquran-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gadingnst","download_url":"https://codeload.github.com/gadingnst/quran-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254582905,"owners_count":22095518,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["al-quran","alquran","alquran-web","hacktoberfest","hacktoberfest2022","indonesia-tafsir","islamic","islamic-works","quran","quran-api","quran-audio","quran-database","quran-json","quran-online","quran-translation","quran-transliteration","quran-web","rest-api","tafsir-surahs","verses"],"created_at":"2024-08-01T21:00:55.087Z","updated_at":"2025-05-16T18:06:44.317Z","avatar_url":"https://github.com/gadingnst.png","language":"JavaScript","funding_links":["https://ko-fi.com/B0B71P7PB"],"categories":["Quranic Text and Reading (386 projects)","Q","JavaScript","hacktoberfest"],"sub_categories":["JavaScript"],"readme":"# Quran - API\n\n\u003e Quran API with media audio ***Syekh. Mishary Rashid Al-Afasy murrotal***.\n\n### Deployment\n\u003e This API has lived at: https://api.quran.gading.dev\n\n#### Terms of using Live API that hosted in https://api.quran.gading.dev\nFYI, this ***Live API*** already has a rate limiter of `10req/5min/address` and `150req/5min for the whole server`. So, you can't rely on this ***Live API*** for continuous use. But, you can cache the API result into *local/client storage*, and your app doesn't need to request the API frequently.\n\nOn the other side, it's ***highly recommended*** to deploy this API with yourself, just click the [Deploy button](#deploy-your-own) below, or clone this repository and deploy it wherever cloud/server you want.\n\n#### Deploy your own!\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/git/external?repository-url=https%3A%2F%2Fgithub.com%2Fsutanlab%2Fquran-api)\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/afrizaloky/quran-api/tree/heroku-deploy)\n\n#### What is the reason behind I limit the incoming requests in this *Live API*?\nYeah, of course I'm glad that this API is known and used by many people. But unfortunately, [Vercel Team](https://vercel.com) noticed that my *Personal Account* has reached its limit. So, that the reason is.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/38345393/172392200-a5297480-ff57-4300-8360-95e3cc7d271d.png\" /\u003e\n\u003c/div\u003e\n\n---\n\n### Introduction\nThis API data source comes from the combination of several parameters from [api.alquran.cloud](https://api.alquran.cloud) and [quran.kemenag.go.id](https://quran.kemenag.go.id) by merging its data to one JSON file with new structure for the better use and performance. Futhermore, this api uses indexed querying techniques with `0(1)` access time which is greatly affects performance.\n\n### Features\n- [x] Arabic Transliteration\n- [x] English and Indonesia translation\n- [x] Verses meta (juz, sajda, manzil, etc)\n- [x] Tafsir surahs and verses (for now, only Bahasa Indonesia)\n- [x] Audio (***Syekh. Mishary Rashid Al-Afasy*** murrotal edition)\n- [ ] Your requests ?\n\n### Data Source\n- [api.alquran.cloud](https://api.alquran.cloud) = Quran, Meta Verses, Audio.\n- [quran.kemenag.go.id](https://quran.kemenag.go.id) = Indonesia translations and tafsir verses (short/long).\n- [Al-Quran-ID-API](https://github.com/bachors/Al-Quran-ID-API) = Indonesia tafsir surah [*note: ambiguous revelation type on surah 13 and 55 in this source. So, I changed it to medinan (according to sahih international data)*]\n\n### Endpoint usage\n- [x] `/surah` = Returns the list of surahs in Al-Quran.\n- [x] `/surah/{surah}` = Returns spesific surah. **Example: [/surah/110](https://api.quran.gading.dev/surah/110)**\n- [x] `/surah/{surah}/{ayah}` = Returns spesific ayah with requested surah. **Example: [/surah/2/255](https://api.quran.gading.dev/surah/2/255)**\n- [x] `/juz/{juz}` = Returns spesific juz with all ayah.**Example: [/juz/2](https://api.quran.gading.dev/juz/2)**\n\n### Recommended fonts for Al-qur'an\n- [quran.musil.com](http://quran.mursil.com/Web-Print-Publishing-Quran-Text-Graphics-Fonts-and-Downloads/fonts-optimized-for-quran)\n- [Uthmani](https://groups.google.com/forum/#!topic/colteachers/Y6iKganK0tQ)\n\n### Available Commands\n- `npm start` = run server.\n- `npm run dev` = run develop server.\n- `npm run crawl` = collect new data from the data source, then unifying it in one JSON file.\n\n### Performance Measurement \u0026 Comparison\n\n#### [api.alquran.cloud](https://api.alquran.cloud)\n\n\u003e Fetching on [Surah 7](https://api.alquran.cloud/surah/7/editions/quran-simple-enhanced,ar.alafasy,en.transliteration,en.sahih,id.indonesian) with audio, en translation \u0026 transliteration, id translation . Result: ***1200++ ms***\n\n[![api.alquran.cloud](https://raw.githubusercontent.com/sutanlab/quran-api/master/screenshots/api.alquran.cloud.jpeg)](https://raw.githubusercontent.com/sutanlab/quran-api/master/screenshots/api.alquran.cloud.jpeg)\n\n#### [api.quran.gading.dev](https://api.quran.gading.dev)\n\n\u003e Fetching on [Surah 7](https://api.quran.gading.dev/surah/7) with audio, en translation \u0026 transliteration, id translation \u0026 tafsir (a lot more data and hosted on free serverless). ***Result: 400++ ms***\n\n[![api.quran.gading.dev](https://raw.githubusercontent.com/sutanlab/quran-api/master/screenshots/api.quran.sutanlab.id.jpeg)](https://raw.githubusercontent.com/sutanlab/quran-api/master/screenshots/api.quran.sutanlab.id.jpeg)\n\n### LICENSE\nMIT\n\n### Support Me\n\n#### Global\n[![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/B0B71P7PB)\n\n#### Indonesia\n- Bank Syariah Mandiri [REK: 7142365973 (SUTAN GADING F NASUTION)]\n- [Trakteer](https://trakteer.id/sutanlab)\n- [Karyakarsa](https://karyakarsa.com/sutanlab)\n\n---\nCopyright © 2020 by Sutan Gading Fadhillah Nasution\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgadingnst%2Fquran-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgadingnst%2Fquran-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgadingnst%2Fquran-api/lists"}