Request for API access: [isfadli]

[isfadli-svg]

• Please tell us about yourself (include an email address):

Muhamad Isfadli and isfadli@altaqua.mosque.sg

• Your purpose in using this API:

I am developing a Telegram bot (@[taquadailybot]) that sends one hadith daily to a private educational channel. The bot is for teaching and didactic purposes, sharing authentic hadith from Imam al-Nawawi's 40 Hadith collection with subscribers. Each day, a single complete hadith (including Arabic text and English translation) will be sent to help people learn and reflect on these foundational teachings. The bot is non-commercial, not monetized, and serves purely educational purposes.

• API rate limits:
  • Maximum requests per second:
  • 1 request per second (the bot sends only 1 hadith per day, so this is very low volume)
  • Maximum requests per day:
  • 40-50 requests per day maximum (for testing and daily operation).

• 1 request for the daily scheduled hadith
• Occasional test requests when debugging
• This is well within reasonable limits

• Is your use case better served by having an offline dump of hadith data or programmatic API access?

Programmatic API access is preferred because:

1. I want to ensure the hadith texts remain accurate and up-to-date
2. The bot will benefit from any future corrections or improvements Sunnah.com makes to their data
3. API access allows for simpler code maintenance without needing to update local databases
4. The very low request volume (1-2 per day) will not burden your servers

However, I understand if you prefer to provide offline data - I can work with either approach.

• What are the languages in which would you like hadith data?

Primary: English (full translation)
Also interested in: Arabic (original text)
Note: Malay would be nice but not required - I can use English and add Malay commentary separately if needed.

• What programming language will your API client be in?

Python 3.x (using the 'requests' library for API calls)