{"id":16157675,"url":"https://github.com/theawiteb/quran_suras_api","last_synced_at":"2025-10-07T07:44:07.853Z","repository":{"id":110116101,"uuid":"379071681","full_name":"TheAwiteb/quran_suras_API","owner":"TheAwiteb","description":null,"archived":false,"fork":false,"pushed_at":"2021-06-21T21:55:53.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-07T01:43:22.397Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheAwiteb.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-21T21:52:46.000Z","updated_at":"2021-10-14T05:44:05.000Z","dependencies_parsed_at":"2023-03-20T13:03:11.741Z","dependency_job_id":null,"html_url":"https://github.com/TheAwiteb/quran_suras_API","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TheAwiteb/quran_suras_API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAwiteb%2Fquran_suras_API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAwiteb%2Fquran_suras_API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAwiteb%2Fquran_suras_API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAwiteb%2Fquran_suras_API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheAwiteb","download_url":"https://codeload.github.com/TheAwiteb/quran_suras_API/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheAwiteb%2Fquran_suras_API/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278740831,"owners_count":26037480,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-10-10T01:50:17.261Z","updated_at":"2025-10-07T07:44:07.833Z","avatar_url":"https://github.com/TheAwiteb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr\u003e\n\u003ch1 align=\"center\"\u003e\n  quran_suras_API\n\u003c/h1\u003e\n\n\n\u003cp align=\"center\"\u003e\nThe API is based on the \u003ca href=https://pypi.org/project/quran-suras\u003equran_suras\u003c/a\u003e library\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#requirements\"\u003erequirements\u003c/a\u003e\n  •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\n  •\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\n  •\n  \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\n  •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n## requirements\n  **\u003e= python3.7**\n\n## Installation\n\n\n```bash\n# Installation\ngit clone https://codeberg.org/Awiteb/quran_suras_API\n# Run\ncd quran_suras_API\npip3 install -r requirements.txt\npython3 app.py\n```\n\n## Features\n* Access to all [quran_suras](https://pypi.org/project/quran-suras) library functions\n\n## Usage\n\n**get surah by number:**\n```python\nimport requests\n\nurl = \"http://127.0.0.1:8000/get_sura_by_number/?sura_number={}\u0026amount={}\"\nsura_number = 2\namount = 1\nsuras = requests.get(url.format(sura_number, amount)).json()\nprint(suras)\n\n```\n\u003cdetails\u003e\n\u003csummary\u003e Example Result\u003c/summary\u003e\n\n```json\n{'ok': True,\n 'result': [{'reader': 'أحمد الحذيفي',\n             'url': 'https://server8.mp3quran.net/ahmad_huth/002.mp3'}],\n 'sura_name': 'البقرة'}\n\n```\n\u003c/details\u003e\n\u003cbr\u003e\u003cbr\u003e\n\n**get surah by name:**\n```python\nimport requests\n\nurl = \"http://127.0.0.1:8000/get_sura_by_name/?sura_name={}\u0026amount={}\"\nsura_name = 'الفرقان'\namount = 1\nsuras = requests.get(url.format(sura_name, amount)).json()\nprint(suras)\n```\n\u003cdetails\u003e\n\u003csummary\u003e Example Result\u003c/summary\u003e\n\n```json\n{'ok': True,\n 'result': [{'reader': 'أحمد الحواشي',\n             'url': 'https://server11.mp3quran.net/hawashi/025.mp3'}],\n 'sura_name': 'الفرقان'}\n```\n\n\u003c/details\u003e\n\u003cbr\u003e\u003cbr\u003e\n\n**get surah name by number:**\n```python\nimport requests\n\nurl = \"http://127.0.0.1:8000/get_sura_name/?sura_number={}\"\nsura_number = 33\nsura_name = requests.get(url.format(sura_number)).json()\nprint(sura_name)\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e Example Result\u003c/summary\u003e\n\n```json\n{'name': 'الأحزاب', 'ok': True}\n```\n\n\u003c/details\u003e\n\u003cbr\u003e\u003cbr\u003e\n\n**get surah number by name:**\n```python\nimport requests\n\nurl = \"http://127.0.0.1:8000/get_sura_number/?sura_name={}\"\nsura_name = 'الناس'\nsura_number = requests.get(url.format(sura_name)).json()\nprint(sura_number)\n\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e Example Result\u003c/summary\u003e\n\n```json\n{'number': 114, 'ok': True}\n```\n\n\u003c/details\u003e\n\u003cbr\u003e\u003cbr\u003e\n\n**get page from quran by page number:**\n```python\nimport requests\n\nurl = \"http://127.0.0.1:8000/get_page/?page_number={}\"\npage_number = 7\npage = requests.get(url.format(page_number)).json()\nprint(page)\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e Example Result\u003c/summary\u003e\n\n```json\nhttps://www.mp3quran.net/api/quran_pages_arabic/601.png{'page_url': 'https://www.mp3quran.net/api/quran_pages_arabic/007.png', 'ok': True}\n```\n\n\u003c/details\u003e\n\u003cbr\u003e\u003cbr\u003e\n\n**get radios by language:**\n```python\nimport requests\n\nurl = \"http://127.0.0.1:8000/get_radios/?language={}\u0026amount={}\"\nlanguage = 'ar'\namount = 1\nradios = requests.get(url.format(language, amount)).json()\nprint(radios)\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e Example Result\u003c/summary\u003e\n\n```json\n{'language': 'ar', 'result': [{'name': '---تراتيل قصيرة متميزة---', 'url': 'http://live.mp3quran.net:9702/'}], 'ok': True}\n\n```\n\n\u003c/details\u003e\n\u003cbr\u003e\u003cbr\u003e\n\n## LICENSE\n[GPLv3](https://www.gnu.org/licenses/gpl-3.0.html)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheawiteb%2Fquran_suras_api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheawiteb%2Fquran_suras_api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheawiteb%2Fquran_suras_api/lists"}