Skip to content

afiyahinfinity/masnun-dua

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📿 Masnun Dua

A free, open-source, multilingual dataset of authentic Islamic Duas, Adhkar, and Supplications

License: Open Source Languages Categories Subcategories

"And your Lord says: Call upon Me; I will respond to you."Quran 40:60


📖 About

This dataset is a comprehensive collection of authentic Duas (supplications) and Adhkar (remembrances of Allah) sourced from the Quran and authentic Hadith. It is maintained by the team behind IslamicAPI.com and made freely available to all developers, researchers, and Islamic application builders.

The dataset covers 1,001+ duas organized into 44 categories and 118 subcategories, fully translated into 53 languages in their native scripts.


✨ Features

  • 🕌 1,001+ authentic duas from Quran & Hadith
  • 🗂️ 44 categories covering all aspects of daily Islamic life
  • 📂 118 subcategories for granular access
  • 🌍 53 languages — all in native script
  • 📁 Clean JSON format — easy to integrate into any app or website
  • 🆓 Completely free — no API key, no rate limits, no fees

📁 Data Structure

/
├── categories/          # Category list per language (44 categories)
│   ├── en.json
│   ├── ar.json
│   └── ... (53 languages)
├── sub-categories/      # Subcategory list per language (118 subcategories)
│   ├── en.json
│   ├── ar.json
│   └── ... (53 languages)
├── audio/               # Audio recitations
├── translation/         # Dua translations per language
└── languages.json       # Full list of supported languages

🚀 How to Use

1. Load Categories

Each file in categories/ contains the full list of 44 categories in that language.

Example — categories/en.json

[
  {
    "name": "Dua's Importance",
    "url": "duas-importance",
    "icon": "dua_s_importance.svg",
    "meta": "7 Subcategories"
  },
  ...
]

Use the url field as the category identifier to filter subcategories and duas.


2. Load Subcategories

Each file in sub-categories/ contains 118 subcategory entries with linked dua IDs.

Example — sub-categories/en.json

[
  {
    "id": 1,
    "title": "The servant is dependent on his Lord",
    "category": "duas-importance",
    "dua-ids": [1, 2, 3]
  },
  ...
]
Field Description
id Unique subcategory ID
title Subcategory title in the target language
category Parent category URL slug (matches categories[].url)
dua-ids Array of dua IDs belonging to this subcategory

3. Match Language

Use languages.json to resolve language codes to display names.

{
  "ar": { "name": "العربية", "name_en": "Arabic" },
  "tr": { "name": "Türkçe", "name_en": "Turkish" },
  ...
}

4. Quick Integration Example (JavaScript)

// Load English categories
const categories = await fetch('categories/en.json').then(r => r.json());

// Load English subcategories
const subcategories = await fetch('sub-categories/en.json').then(r => r.json());

// Filter subcategories by category
const morningDuas = subcategories.filter(s => s.category === 'morning-and-evening');

// Get all dua IDs for the first subcategory
const duaIds = morningDuas[0]['dua-ids'];

5. Quick Integration Example (Python)

import json

# Load Arabic subcategories
with open('sub-categories/ar.json', encoding='utf-8') as f:
    subcategories = json.load(f)

# Filter by category
salah_subs = [s for s in subcategories if s['category'] == 'salah']
print(f"Found {len(salah_subs)} subcategories under Salah")

🗂️ Categories (44 Total)

# Category URL Slug Subcategories
1 Dua's Importance duas-importance 7
2 Dua's Excellence duas-excellence 1
3 Time of Dua time-of-dua 1
4 Dua Acceptance dua-acceptance 1
5 Morning & Evening morning-and-evening 3
6 Sleep sleep 2
7 Cloths cloths 1
8 Home home 2
9 Toilet toilet 1
10 Adhaan & Iqamah adhaan-and-iqamah 4
11 Ablution & Bath ablution-and-bath 2
12 Mosque mosque 5
13 Salah salah 17
14 Witr & Other witr-and-other 6
15 Grave / Funeral grave-funeral 5
16 Fasting fasting 1
17 Travel travel 1
18 Hajj & Umrah hajj-and-umrah 1
19 Sacrifice sacrifice 1
20 Evil Protection evil-protection 6
21 Forgiveness forgiveness 4
22 Marriage marriage 3
23 Family family 1
24 Debt debt 1
25 Anxiety anxiety 1
26 Danger danger 4
27 Condemnation/Praise condemnationpraise 2
28 Manners manners 7
29 Gathering gathering 1
30 Food food 6
31 Animals animals 1
32 Rain/Nature rainnature 1
33 Sickness sickness 3
34 Jinn/Diseases jinndiseases 2
35 Quranic Dua quranic-dua 4
36 Greatest Name of Allah greatest-name-of-allah 1
37 Prophet's Dua prophets-dua 1
38 Duas of Hadith duas-of-hadith 1
39 Duas of Sahaba duas-of-sahaba 1
40 Masnun Duas masnun-duas 1
41 Other Duas other-duas 1
42 When to Say What when-to-say-what 1
43 Eid eid 1
44 40 Rabbana Duas 40-rabbana-duas 1

🌍 Multilingual Support (53 Languages)

All categories and subcategories are available in the following languages with native script:

Code Language Native Name Script
am Amharic አማርኛ Ethiopic
ar Arabic العربية Arabic
az Azerbaijani Azərbaycan Latin
bg Bulgarian Български Cyrillic
bn Bengali বাংলা Bengali
bs Bosnian Bosanski Latin
cs Czech Čeština Latin
da Danish Dansk Latin
de German Deutsch Latin
dv Dhivehi ދިވެހި Thaana
el Greek Ελληνικά Greek
en English English Latin
es Spanish Español Latin
et Estonian Eesti Latin
fa Persian فارسی Arabic
fi Finnish Suomi Latin
fr French Français Latin
gu Gujarati ગુજરાતી Gujarati
ha Hausa Hausa Latin
haw Hawaiian ʻŌlelo Hawaiʻi Latin
he Hebrew עברית Hebrew
hi Hindi हिन्दी Devanagari
hr Croatian Hrvatski Latin
hu Hungarian Magyar Latin
hy Armenian Հայերեն Armenian
id Indonesian Bahasa Indonesia Latin
is Icelandic Íslenska Latin
it Italian Italiano Latin
ja Japanese 日本語 CJK
ka Georgian ქართული Georgian
kk Kazakh Қазақ тілі Cyrillic
km Khmer ភាសាខ្មែរ Khmer
kn Kannada ಕನ್ನಡ Kannada
ko Korean 한국어 Hangul
ku Kurdish کوردی Arabic
lo Lao ລາວ Lao
lt Lithuanian Lietuvių Latin
ml Malayalam മലയാളം Malayalam
mr Marathi मराठी Devanagari
ms Malay Bahasa Melayu Latin
mt Maltese Malti Latin
my Burmese မြန်မာဘာသာ Myanmar
ne Nepali नेपाली Devanagari
pa Punjabi ਪੰਜਾਬੀ Gurmukhi
pt Portuguese Português Latin
ro Romanian Română Latin
ru Russian Русский Cyrillic
ta Tamil தமிழ் Tamil
te Telugu తెలుగు Telugu
th Thai ไทย Thai
tr Turkish Türkçe Latin
ur Urdu اردو Arabic
zh Chinese 中文 CJK

⚠️ Usage Guidelines

This dataset is free for everyone — for apps, websites, research, and educational use.

We ask that you:

  • ✅ Use it for any purpose — personal, educational, or commercial
  • ✅ Use it for the benefit of Islam and Muslims
  • ✅ Share corrections or improvements via a Pull Request
  • Do not share false, fabricated, or unauthentic information as Islamic content
  • Do not use it for purposes that contradict Islamic values

No attribution required. This is completely free and open source.
The duas in this dataset are sourced from the Quran and authentic Hadith. Please maintain their integrity.


🐛 Found an Issue?

If you notice any incorrect translation, missing data, or a bug:

  1. Open a Pull Request on this repository with your fix
  2. Or email us at support@islamicapi.com

We review all submissions carefully to maintain authenticity and accuracy.


🤝 Credits & Acknowledgements

This dataset was built with the help of the following books, apps, and resources:

Resource Author/Source
📖 Holy Quran
📚 Kutub as-Sittah (Six Major Hadith Collections)
📚 Rahe Belayat Dr. Khondokar Abdullah Jahangir
📚 Hisnul Muslim Said ibn Ali Al-Qahtani
📚 الذكر والدعاء والعلاج بالرقى من الكتاب والسنة Said ibn Ali Al-Qahtani
📚 Jinn and Jinn-related Illnesses
📚 Health and Medical Science in the View of Islam Shaikhul Hadith Maulana Abdur Rauf Shamim
📚 The Effect of Jinn on Humans: Causes, Remedies and Protection Abdullah Shahid Abdur Rahman
📚 Hijama Ruqyah Abdus Sabur Chowdhury
📚 Treatment of Evil Eye, Magic and Jinn Abu Ahmad Saifuddin Belal
📚 وقاية الإنسان من الجن والشيطان Sheikh Wahid bin Abdus Salam Bali
📚 الصارم البتار في التصدي للسحرة الأشرار Sheikh Wahid bin Abdus Salam Bali
📚 ارق نفسك وأهلك بنفسك Dr. Khalid Al-Juraisi
📚 الفتاوى الذهبية في الرقى الشرعية Dr. Khalid Al-Juraisi
📚 عالم الجن والشياطين Omar Suleiman Al-Ashqar
📚 الحصن الحصين Imam Muhammad Ibn Al-Jazari Shafi'i
📱 Mobile App: الباحث الحديثي
📱 Mobile App: تراث
🌐 Duaruqyah Website duaruqyah.com
🤝 Financial Contributors Those who supported IslamicAPI's development

📜 License

This dataset is completely free and open source — use it for any purpose including personal, educational, or commercial projects. No attribution required.

"Whoever guides someone to goodness will have a reward like the one who did it."Sahih Muslim


Made with ❤️ for the Ummah by the IslamicAPI team

Questions or support?support@islamicapi.com

About

Free & authentic data collection of Masnun Dua

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors