Assalāmu ʿalaykum, jazākum Allāhu khayran for maintaining sunnah.com and the open API. Your work has made authentic hadith accessible to so many of us; I want Ilm to extend that benefit, not extract from it.
-
Please tell us about yourself (include an email address):
Praditya Putra, a Muslim developer, building a free non-commercial companion app for the Ummah. Email: praditya.s.putra@gmail.com
-
Your purpose in using this API:
I am building a free mobile app called Ilm (iOS + Android, React Native + Supabase, no ads, no in-app purchases, no paywall). Ilm helps Muslims find verses of the Qurʾān and authentic hadith relevant to what they are going through — anxiety, grief, gratitude, repentance, parenting, work, illness, and similar life situations. I would use sunnah.com data to ingest authentic hadith collections (Sahih al-Bukhari, Sahih Muslim, the rest of the Kutub as-Sittah, Riyāḍ aṣ-Ṣāliḥīn, 40 Hadith Nawawi and Qudsi) into our database for offline lookup inside the app. Every hadith displayed in Ilm will show its full citation (collection, book, hadith number, grade) and a direct link back to its sunnah.com page so users can read the surrounding chapter and isnad.
-
API rate limits:
Maximum requests per second: 2
Maximum requests per day: 10,000 during the initial one-time bulk ingest (which I expect to spread across 2–3 days), and under 100/day after that for incremental updates and corrections. Local caching means we hit the API once per hadith, not per user.
-
Is your use case better served by having an offline dump of hadith data or programmatic API access?
An offline dump would actually suit my use case better than the API — I only need to ingest each hadith once into our own Postgres, and would prefer not to add load to your servers for a one-time bulk read. I noticed in your developer docs that an offline dump is "not available yet"; if that changes, I would be very grateful to receive a snapshot instead. In the meantime, the API works for me.
-
What are the languages in which would you like hadith data?
Arabic (original) and English at launch. Bahasa Indonesia would be a high priority for a later release if available, since I am Indonesian and a large portion of the target audience speaks Bahasa.
-
What programming language will your API client be in?
TypeScript on Node.js (the offline ingest pipeline is a tsx script). The mobile app itself is React Native (TypeScript) but it queries our own Supabase Postgres, not your API directly.
Assalāmu ʿalaykum, jazākum Allāhu khayran for maintaining sunnah.com and the open API. Your work has made authentic hadith accessible to so many of us; I want Ilm to extend that benefit, not extract from it.
Please tell us about yourself (include an email address):
Praditya Putra, a Muslim developer, building a free non-commercial companion app for the Ummah. Email: praditya.s.putra@gmail.com
Your purpose in using this API:
I am building a free mobile app called Ilm (iOS + Android, React Native + Supabase, no ads, no in-app purchases, no paywall). Ilm helps Muslims find verses of the Qurʾān and authentic hadith relevant to what they are going through — anxiety, grief, gratitude, repentance, parenting, work, illness, and similar life situations. I would use sunnah.com data to ingest authentic hadith collections (Sahih al-Bukhari, Sahih Muslim, the rest of the Kutub as-Sittah, Riyāḍ aṣ-Ṣāliḥīn, 40 Hadith Nawawi and Qudsi) into our database for offline lookup inside the app. Every hadith displayed in Ilm will show its full citation (collection, book, hadith number, grade) and a direct link back to its sunnah.com page so users can read the surrounding chapter and isnad.
API rate limits:
Maximum requests per second: 2
Maximum requests per day: 10,000 during the initial one-time bulk ingest (which I expect to spread across 2–3 days), and under 100/day after that for incremental updates and corrections. Local caching means we hit the API once per hadith, not per user.
Is your use case better served by having an offline dump of hadith data or programmatic API access?
An offline dump would actually suit my use case better than the API — I only need to ingest each hadith once into our own Postgres, and would prefer not to add load to your servers for a one-time bulk read. I noticed in your developer docs that an offline dump is "not available yet"; if that changes, I would be very grateful to receive a snapshot instead. In the meantime, the API works for me.
What are the languages in which would you like hadith data?
Arabic (original) and English at launch. Bahasa Indonesia would be a high priority for a later release if available, since I am Indonesian and a large portion of the target audience speaks Bahasa.
What programming language will your API client be in?
TypeScript on Node.js (the offline ingest pipeline is a tsx script). The mobile app itself is React Native (TypeScript) but it queries our own Supabase Postgres, not your API directly.