Please tell us about yourself (include an email address):
Name: Ibragim
Email: hasanza.ibragim@inbox.ru
I am building a personal, non-commercial study system for my own use. It processes recorded Islamic lectures and Arabic-language courses (e.g. Ali Hammuda's "Change of Heart" series, Madrasatuna's Madinah Arabic books) into structured study notes stored locally in an Obsidian vault.
Your purpose in using this API:
The core problem I am solving is citation accuracy. Automatic speech recognition mangles Arabic terms and cannot reliably reproduce hadith text, narrators, or gradings from lecture audio. Rather than let software reconstruct a citation phonetically — which risks misattribution — I want every hadith referenced in a lecture resolved against sunnah.com as the canonical source, so the stored note carries the correct text, narrator, collection, reference number and grading. Anything that cannot be resolved is explicitly flagged as unverified rather than guessed.
Usage is read-only and strictly for my personal study notes. Nothing is published, redistributed, or served to other users. Hadith text will not be modified, abridged in a way that changes meaning, or presented without attribution to sunnah.com.
API rate limits:
Maximum requests per second: 1 request/second
Maximum requests per day: 1,000 requests/day
Actual usage will be well below this. A typical lecture contains a handful of hadith citations, and results are cached locally so the same hadith is never fetched twice.
Is your use case better served by having an offline dump of hadith data or programmatic API access?
An offline dump would be strongly preferred and would suit this use case better. The workload is batch processing of recorded lectures rather than interactive traffic, so local lookup would be faster, would place no load on your servers, and would let me verify citations without network access. I understand from the developers page that a dump is not yet available; programmatic API access works in the meantime.
What are the languages in which would you like hadith data?
Arabic and English. Arabic is essential — preserving the original wording of the hadith is the main reason I am requesting access rather than relying on transcribed audio.
What programming language will your API client be in?
Python, with shell tooling (yt-dlp, ffmpeg, Whisper) for the transcription stage. The client is a local command-line pipeline, not a hosted service.
Please tell us about yourself (include an email address):
Name: Ibragim
Email: hasanza.ibragim@inbox.ru
I am building a personal, non-commercial study system for my own use. It processes recorded Islamic lectures and Arabic-language courses (e.g. Ali Hammuda's "Change of Heart" series, Madrasatuna's Madinah Arabic books) into structured study notes stored locally in an Obsidian vault.
Your purpose in using this API:
The core problem I am solving is citation accuracy. Automatic speech recognition mangles Arabic terms and cannot reliably reproduce hadith text, narrators, or gradings from lecture audio. Rather than let software reconstruct a citation phonetically — which risks misattribution — I want every hadith referenced in a lecture resolved against sunnah.com as the canonical source, so the stored note carries the correct text, narrator, collection, reference number and grading. Anything that cannot be resolved is explicitly flagged as unverified rather than guessed.
Usage is read-only and strictly for my personal study notes. Nothing is published, redistributed, or served to other users. Hadith text will not be modified, abridged in a way that changes meaning, or presented without attribution to sunnah.com.
API rate limits:
Maximum requests per second: 1 request/second
Maximum requests per day: 1,000 requests/day
Actual usage will be well below this. A typical lecture contains a handful of hadith citations, and results are cached locally so the same hadith is never fetched twice.
Is your use case better served by having an offline dump of hadith data or programmatic API access?
An offline dump would be strongly preferred and would suit this use case better. The workload is batch processing of recorded lectures rather than interactive traffic, so local lookup would be faster, would place no load on your servers, and would let me verify citations without network access. I understand from the developers page that a dump is not yet available; programmatic API access works in the meantime.
What are the languages in which would you like hadith data?
Arabic and English. Arabic is essential — preserving the original wording of the hadith is the main reason I am requesting access rather than relying on transcribed audio.
What programming language will your API client be in?
Python, with shell tooling (yt-dlp, ffmpeg, Whisper) for the transcription stage. The client is a local command-line pipeline, not a hosted service.