Skip to content

islamicapi/ruqyah

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📿 Dua Ruqyah

A free, open-source, multilingual dataset of authentic Islamic Ruqyah recitations and educational content

License: Open Source Languages Ruqyah Entries Topic Articles

"And We send down of the Quran that which is a healing and a mercy for the believers."Quran 17:82


📖 About

This dataset is a comprehensive collection of authentic Ruqyah Shariah recitations and educational articles 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 includes:

  • 308 Ruqyah recitations organized into 3 programs (Brief, Medium, and Long), each split by Quranic verses and Sunnah supplications
  • 146 educational articles across 13 topic categories covering all aspects of Ruqyah Shariah
  • Fully translated into 53 languages in their native scripts

✨ Features

  • 🕌 308 authentic Ruqyah entries from Quran & Sunnah
  • 🗂️ 3 Ruqyah programs — Brief, Medium, and Long — for different needs
  • 📚 146 topic articles covering Jinn, Black Magic, Evil Eye, Hijamah, and more
  • 🌍 53 languages — all in native script
  • 📁 Clean JSON format — easy to integrate into any app or website
  • 🎵 Audio recitations available for download separately (see Audio)
  • 🆓 Completely free — no API key, no rate limits, no fees

📁 Data Structure

/
├── translation/              # All translated content per language (53 languages)
│   ├── en/
│   │   ├── instant/          # Ruqyah recitation programs
│   │   │   ├── categories.json
│   │   │   ├── brief-ruqya/
│   │   │   │   ├── from-quran/   # 9 entries (1.json … 9.json)
│   │   │   │   └── from-sunnah/  # 13 entries
│   │   │   ├── a-medium-ruqya/
│   │   │   │   ├── from-quran/   # 63 entries
│   │   │   │   └── from-sunnah/  # 18 entries
│   │   │   └── a-long-ruqya/
│   │   │       ├── from-quran/   # 171 entries
│   │   │       └── from-sunnah/  # 34 entries
│   │   └── topics/           # Educational topic articles
│   │       ├── categories.json
│   │       ├── introduction-to-ruqyah/   # 11 articles
│   │       ├── protect-yourself-from-jinn/
│   │       ├── black-magic-sihr/
│   │       └── ... (13 topics total)
│   ├── ar/
│   └── ... (53 languages)
├── audio/                    # Audio recitations
├── assets/                   # Icons and static assets
└── languages.json            # Full list of supported languages

🚀 How to Use

1. Load Instant Ruqyah Categories

instant/categories.json lists the 3 Ruqyah programs with their entries.

Example — translation/en/instant/categories.json

[
  {
    "title": "Brief Ruqya",
    "icon": "assets/instant/icons/brief-ruqya.svg",
    "subcategories": [
      {
        "subcategory": "From Quran",
        "subcategory-slug": "from-quran",
        "ruqyah": [
          { "id": "1", "title": "Al-Fatiha 1:1-7" }
        ]
      },
      {
        "subcategory": "From Sunnah",
        "subcategory-slug": "from-sunnah",
        "ruqyah": [
          { "id": "1", "title": "Abu Dawud : 775" }
        ]
      }
    ]
  }
]

2. Load a Ruqyah Entry

Each numbered JSON file inside from-quran/ or from-sunnah/ contains one Ruqyah recitation.

Example — translation/en/instant/brief-ruqya/from-quran/1.json

{
  "id": 1,
  "title": "Al-Fatiha 1:1-7",
  "introduction": "",
  "arabic": "بِسْمِ اللَّـهِ الرَّحْمَـٰنِ الرَّحِيمِ ...",
  "transliteration": "",
  "translation": "In the name of Allah, the Entirely Merciful...",
  "reference": "",
  "category": "Brief Ruqya",
  "sub_category": "From Quran"
}
Field Description
id Entry ID within its program and source
title Surah/verse reference or Hadith reference
arabic Full Arabic text
transliteration Romanized pronunciation (where available)
translation Meaning in the target language
reference Source reference
category Ruqyah program name
sub_category Source — From Quran or From Sunnah

3. Load Topic Categories

topics/categories.json lists all 13 topic categories with their article titles and IDs.

Example — translation/en/topics/categories.json

[
  {
    "title": "Introduction to Ruqyah",
    "icon": "assets/topics/icons/introduction-to-ruqyah.svg",
    "subcategories": [
      {
        "subcategory": "Introduction to Ruqyah",
        "subcategory-slug": "introduction-to-ruqyah",
        "ruqyah": [
          { "id": "1", "title": "Ruqyah Shariah in Islam - Quranic Healing for Evil Eye & Magic" }
        ]
      }
    ]
  }
]

4. Load a Topic Article

Each numbered JSON file inside a topic folder contains one article with rich structured content.

Example — translation/en/topics/introduction-to-ruqyah/1.json

{
  "id": 1,
  "sub_id": 1,
  "title": "Ruqyah Shariah in Islam",
  "section_title": "What is Ruqyah?",
  "category": "Introduction to Ruqyah",
  "content": [
    { "type": "text", "content": "Ruqyah is the practice of treating illnesses..." },
    { "type": "arabic", "content": "وَنُنَزِّلُ مِنَ الْقُرْآنِ..." },
    { "type": "translation", "content": "We send down in the Quran that which is a cure..." }
  ]
}

Content blocks use the type field: text, arabic, or translation.


5. 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" }
}

6. Quick Integration Example (JavaScript)

// Load Ruqyah programs list
const categories = await fetch('translation/en/instant/categories.json').then(r => r.json());

// Load a specific Ruqyah entry
const entry = await fetch('translation/en/instant/brief-ruqya/from-quran/1.json').then(r => r.json());

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

// Load a specific topic article
const article = await fetch('translation/en/topics/introduction-to-ruqyah/1.json').then(r => r.json());

7. Quick Integration Example (Python)

import json

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

# Load a specific Ruqyah entry
with open('translation/ar/instant/a-long-ruqya/from-quran/1.json', encoding='utf-8') as f:
    entry = json.load(f)
    print(entry['arabic'])

🗂️ Instant Ruqyah Programs

Program From Quran From Sunnah Total
Brief Ruqya 9 13 22
A Medium Ruqya 63 18 81
A Long Ruqya 171 34 205
Total 243 65 308

📚 Topics (13 Categories, 146 Articles)

# Topic Slug Articles
1 Introduction to Ruqyah introduction-to-ruqyah 11
2 Protect Yourself From Jinn protect-yourself-from-jinn 28
3 Black Magic (Sihr) black-magic-sihr 26
4 Evil Eye & Envy evil-eye-and-envy 18
5 About Raqi about-raqi 16
6 Types of Hijamah / Bloodletting types-of-hijamah-bloodletting 11
7 Ruqyah Materials ruqyah-materials 9
8 7-Day Detoxification Program 7-day-detoxification-program 7
9 Waswasah - Whisperings waswasah-whisperings 5
10 The Ruqyah Bath Against Sihr the-ruqyah-bath-against-sihr 5
11 Other Diseases other-diseases 5
12 Treatment for General Problems treatment-for-general-problems 4
13 Full Ruqyah Program full-ruqyah-program 1

🌍 Multilingual Support (53 Languages)

All Ruqyah programs and topic articles 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

🎵 Audio

Audio files are not included in this repository due to their large size.

Download the full audio pack and extract it into the audio/ folder:

Download audio.zip

http://islamicapi.com/audio/ruqyah/all.zip

⚠️ 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 Ruqyah recitations 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

A free, open-source, multilingual dataset of authentic Islamic Ruqyah recitations and educational content

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors