- Please tell us about yourself (include an email address):
Assalamu alaikum,
My name is Akbar Ali and I am an undergraduate Computer Science student at Queen Mary University of London. My email address is akbaraali06@gmail.com
I am currently taking part in a Muslim hackathon where my team is building a prototype application to help users verify Islamic claims found in social media content.
- Your purpose in using this API:
We would like to use the Sunnah.com API for a hackathon project called a source-backed Islamic content checker.
The application will allow users to paste a transcript or upload short social media clips. The system will extract religious claims from the content and cross-reference them against trusted Islamic sources, including Hadith collections. The aim is not to issue fatwas or make final religious rulings, but to help users identify whether a claim is supported by reliable Hadith evidence, whether the narration is weak, or whether no clear source was found.
The app will display the Hadith text, collection, reference, and grading where available, so users can understand the reliability of what they are seeing before sharing it further. We will also include clear disclaimers that complex matters should be referred to qualified scholars.
This is currently an educational, non-commercial hackathon prototype with low expected usage.
- API rate limits:
- Maximum requests per second:
- Maximum requests per day:
Maximum requests per second: 2 requests per second
Maximum requests per day: 500 requests per day
- Is your use case better served by having an offline dump of hadith data or programmatic API access?
For the hackathon prototype, programmatic API access would be useful because we want to search and retrieve Hadith data dynamically when a user submits a claim.
However, an offline snapshot of Hadith data would also be very useful for development and demo purposes, especially to reduce unnecessary API calls and avoid overloading the service. If an offline dump is more appropriate for our use case, we would be happy to use that instead, while following any attribution and usage guidelines.
- What are the languages in which would you like hadith data?
English and Arabic.
English is needed for the main user-facing prototype, while Arabic would be useful for displaying the original Hadith text alongside the translation where available.
- What programming language will your API client be in?
JavaScript / TypeScript.
We are planning to build the application using React or Next.js, with backend API routes written in JavaScript/TypeScript.
Assalamu alaikum,
My name is Akbar Ali and I am an undergraduate Computer Science student at Queen Mary University of London. My email address is akbaraali06@gmail.com
I am currently taking part in a Muslim hackathon where my team is building a prototype application to help users verify Islamic claims found in social media content.
We would like to use the Sunnah.com API for a hackathon project called a source-backed Islamic content checker.
The application will allow users to paste a transcript or upload short social media clips. The system will extract religious claims from the content and cross-reference them against trusted Islamic sources, including Hadith collections. The aim is not to issue fatwas or make final religious rulings, but to help users identify whether a claim is supported by reliable Hadith evidence, whether the narration is weak, or whether no clear source was found.
The app will display the Hadith text, collection, reference, and grading where available, so users can understand the reliability of what they are seeing before sharing it further. We will also include clear disclaimers that complex matters should be referred to qualified scholars.
This is currently an educational, non-commercial hackathon prototype with low expected usage.
Maximum requests per second: 2 requests per second
Maximum requests per day: 500 requests per day
For the hackathon prototype, programmatic API access would be useful because we want to search and retrieve Hadith data dynamically when a user submits a claim.
However, an offline snapshot of Hadith data would also be very useful for development and demo purposes, especially to reduce unnecessary API calls and avoid overloading the service. If an offline dump is more appropriate for our use case, we would be happy to use that instead, while following any attribution and usage guidelines.
English and Arabic.
English is needed for the main user-facing prototype, while Arabic would be useful for displaying the original Hadith text alongside the translation where available.
JavaScript / TypeScript.
We are planning to build the application using React or Next.js, with backend API routes written in JavaScript/TypeScript.