Hadith data for your app.
Structured access to hadith collections from 14 imams — Arabic text, translations, sanad, and authenticity status. Designed for apps, bots, and research purposes.
No spam. Only news when the testing phase opens.
What you can build
Some use cases we are envisioning. If you have other ideas, we'd love to hear them.
Mobile apps
Build hadith apps, daily reminders, or interactive quizzes with curated data.
Web & dashboards
Embed hadith search into websites, dakwah portals, or internal organizational apps.
Bots & automation
Deliver daily hadiths on Telegram, Discord, WhatsApp, or any notification system.
Research & education
Structured access to Arabic text, translations, and sanad metadata for academic purposes.
API Principles
Just like the HadisKu app, the API will be built with simple assumptions and without compromising privacy.
Open access
Designed to be used by individual developers and small institutions without unreasonable cost barriers.
Privacy first
No end-user tracking, no data stored longer than necessary to serve requests.
Verified data
Each hadith includes the book, reference number, and authenticity status — clear sources, no missing parts.
Fast & lightweight
Clean JSON responses, cacheable, and distributed via a global CDN.
Current progress
What is finished and what is still being worked on. Transparent, without unrealistic dates.
- Hadith data schema (Arabic text, translation, sanad, status).
- Basic search endpoints and retrieval by number.
- Public documentation and integration examples.
- Access key system and rate limiting.
- Usage policy and attribution terms.
Frequently Asked Questions
When will this API be available?
We are preparing documentation, an access key system, and internal testing. The release date is not yet set. Follow the newsletter to get news when the testing phase opens.
Is this API free?
Our plan is to provide a free tier for fair use, with paid options for higher volumes. Details are not final and will be announced before release.
Will this API require attribution?
Most likely yes, in a simple form such as mentioning HadisKu as the data source. The full policy will be published alongside the documentation.
Can I join the early testing?
Yes — newsletter subscribers will get priority when the testing phase opens. We are also open to discussions with developers who have specific needs.
Want to know first?
Follow the newsletter for release news, or send an email if you want to discuss integration needs in more detail.