Skip to content

Free Hadith API Service with Multiple Languages and Multiple Grades

License

Notifications You must be signed in to change notification settings

fawazahmed0/hadith-api

Repository files navigation

Hadith API

In the name of God, who has guided me to do this work

Features:

  • Free & Blazing Fast response
  • No Rate limits
  • Multiple Languages
  • Multiple Grades

URL Structure:

https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-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

Lists all the available editions in prettified json format:
https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions.json

Get a minified version of it:
https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions.min.json

  • /editions/{editionName}

Get the whole hadith/hadith translation:
https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions/eng-abudawud.json

  • /editions/{editionName}/{HadithNo}

Get the 1035th Hadith:
https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions/eng-abudawud/1035.json

Get the 1035th Hadith in minified format:
https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions/eng-abudawud/1035.min.json

  • /editions/{editionName}/sections/{sectionNo}

Get Section 7:
https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions/eng-abudawud/sections/7.json

  • /info

Get all the details about hadith book, such as hadith grades, books reference etc
https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/info.json

Contribution:

Without your contribution, this work won't survive, whenever you find any issue, 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
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

Any Issues: Raise here

Demos:

Projects using Hadith API:

Other Similar Projects:

Share:

Please share this with your friends and Star this repo by clicking on ⭐ button above ↗️

References:

All the open source projects and dawah/Islamic organizations

Please see References




✏️Improve this page