Ruqyah API Documentation

Base Request

GET https://islamicapi.com/api/v1/ruqyah/?type={type}&lang={lang}&api_key={YOUR_API_KEY}

Query Parameters

`type` required

Specifies which data to return. Must be one of the five allowed values below.

Allowed values:

instant-category — Returns the 3 Ruqyah programs (Brief, Medium, Long) with their full entry lists for the given language.

instant — Returns Ruqyah recitation entries for a specific program and source. Requires program and source. Supports optional id and random.

topic-category — Returns all 13 topic categories with their article lists for the given language.

topic — Returns educational articles for a specific topic. Requires topic. Supports optional id and random.

language — Returns the full list of supported languages. Does not require the lang parameter.

`lang` required*

ISO language code. Not required when type=language.

Example: en, bn, ar, hi

`program` required for instant

Only used when type=instant. Selects the Ruqyah program.

brief-ruqya — 22 entries (9 Quran + 13 Sunnah)

a-medium-ruqya — 81 entries (63 Quran + 18 Sunnah)

a-long-ruqya — 205 entries (171 Quran + 34 Sunnah)

`source` required for instant

Only used when type=instant. Filters entries by source.

from-quran — Quranic verse recitations

from-sunnah — Prophetic supplication recitations

`topic` required for topic

Only used when type=topic. Selects the topic category by slug.

introduction-to-ruqyah — 11 articles

protect-yourself-from-jinn — 28 articles

black-magic-sihr — 26 articles

evil-eye-and-envy — 18 articles

about-raqi — 16 articles

types-of-hijamah-bloodletting — 11 articles

ruqyah-materials — 9 articles

7-day-detoxification-program — 7 articles

waswasah-whisperings — 5 articles

the-ruqyah-bath-against-sihr — 5 articles

other-diseases — 5 articles

treatment-for-general-problems — 4 articles

full-ruqyah-program — 1 article

`id` optional

Only for type=instant or type=topic. Returns a single entry/article by its numeric ID. Takes priority over random.

Example: id=1

`random` optional

Only for type=instant or type=topic. Set to true to receive a single randomly selected entry. Ignored if id is also provided.

Example: random=true

Priority rule for type=instant and type=topic:
id > random=true > return all entries (default)

1. Get Instant Ruqyah Categories

Returns the 3 Ruqyah programs (Brief, Medium, Long) with their full structured entry lists. Each program lists its subcategories (From Quran and From Sunnah) with every entry's ID and title.

Request

GET https://islamicapi.com/api/v1/ruqyah/?type=instant-category&lang=en&api_key={YOUR_API_KEY}

JSON Response (success)

{
    "status": "success",
    "message": "Instant categories fetched successfully",
    "data": [
        {
            "title": "Brief Ruqya",
            "subcategories": [
                {
                    "subcategory": "From Quran",
                    "subcategory-slug": "from-quran",
                    "ruqyah": [
                        { "id": "1", "title": "Al-Fatiha 1:1-7" },
                        { "id": "2", "title": "Al-Baqarah 2:1-5" },
                        // ... 9 entries total
                    ]
                },
                {
                    "subcategory": "From Sunnah",
                    "subcategory-slug": "from-sunnah",
                    "ruqyah": [
                        { "id": "1", "title": "Abu Dawud : 775" },
                        // ... 13 entries total
                    ]
                }
            ]
        },
        {
            "title": "A Medium Ruqya",
            // ... 81 entries
        },
        {
            "title": "A Long Ruqya",
            // ... 205 entries
        }
    ]
}

2. Get All Ruqyah Entries (a program + source)

Returns all Ruqyah recitation entries for the specified program and source, sorted by ID. Each entry contains the Arabic text, transliteration, translation, reference, category, and sub-category.

Request

GET https://islamicapi.com/api/v1/ruqyah/?type=instant&lang=en&program=brief-ruqya&source=from-quran&api_key={YOUR_API_KEY}

JSON Response (success)

{
    "status": "success",
    "message": "Ruqyah entries fetched successfully",
    "data": [
        {
            "id": 1,
            "title": "Al-Fatiha 1:1-7",
            "introduction": "",
            "arabic": "بِسْمِ اللَّـهِ الرَّحْمَـٰنِ الرَّحِيمِ ...",
            "transliteration": "",
            "translation": "(1) In the name of Allah, the Entirely Merciful ...",
            "reference": "",
            "category": "Brief Ruqya",
            "sub_category": "From Quran"
        },
        {
            "id": 2,
            "title": "Al-Baqarah 2:1-5",
            ...
        }
        // ... all entries for this program + source
    ]
}

3. Get a Specific Ruqyah Entry by ID

Returns a single Ruqyah entry object for the given id. The id is specific to the combination of program and source.

Request

GET

https://islamicapi.com/api/v1/ruqyah/?type=instant&lang=en&program=a-medium-ruqya&source=from-sunnah&id=3&api_key={YOUR_API_KEY}

JSON Response (success)

{
    "status": "success",
    "message": "Ruqyah entry fetched successfully",
    "data": {
        "id": 3,
        "title": "Muslim : 2708",
        "introduction": "...",
        "arabic": "أَعُوذُ بِكَلِمَاتِ اللهِ التَّامَّاتِ ...",
        "transliteration": "A'oodhu bikalimaatil-laahit-taammaati ...",
        "translation": "I seek refuge in the perfect words of Allah ...",
        "reference": "Muslim : 2708",
        "category": "A Medium Ruqya",
        "sub_category": "From Sunnah"
    }
}

4. Get a Random Ruqyah Entry

Returns a single randomly selected entry from the specified program and source.

Request

GET

https://islamicapi.com/api/v1/ruqyah/?type=instant&lang=en&program=a-long-ruqya&source=from-quran&random=true&api_key={YOUR_API_KEY}

JSON Response (success)

{
    "status": "success",
    "message": "Random ruqyah entry fetched successfully",
    "data": {
        "id": 47,
        "title": "Al-Baqarah 2:97-98",
        "introduction": "",
        "arabic": "...",
        "transliteration": "",
        "translation": "...",
        "reference": "",
        "category": "A Long Ruqya",
        "sub_category": "From Quran"
    }
}

5. Get Topic Categories

Returns all 13 educational topic categories with their article titles and IDs. Use the subcategory-slug values as the topic parameter when calling type=topic.

Request

GET https://islamicapi.com/api/v1/ruqyah/?type=topic-category&lang=en&api_key={YOUR_API_KEY}

JSON Response (success)

{
    "status": "success",
    "message": "Topic categories fetched successfully",
    "data": [
        {
            "title": "Introduction to Ruqyah",
            "subcategories": [
                {
                    "subcategory": "Introduction to Ruqyah",
                    "subcategory-slug": "introduction-to-ruqyah",
                    "ruqyah": [
                        { "id": "1", "title": "Ruqyah Shariah in Islam - Quranic Healing for Evil Eye & Magic" },
                        { "id": "2", "title": "..." },
                        // ... 11 articles
                    ]
                }
            ]
        },
        {
            "title": "Protect Yourself From Jinn",
            // ... 28 articles
        },
        // ... 13 categories total
    ]
}

6. Get All Articles in a Topic

Returns all educational articles for the specified topic, sorted by article ID. Each article contains structured content blocks (text, arabic, translation, header).

Request

GET https://islamicapi.com/api/v1/ruqyah/?type=topic&lang=en&topic=black-magic-sihr&api_key={YOUR_API_KEY}

JSON Response (success)

{
    "status": "success",
    "message": "Topic articles fetched successfully",
    "data": [
        {
            "sub_id": 1,
            "title": "What is Black Magic (Sihr)?",
            "section_title": "Definition of Sihr",
            "category": "Black Magic (Sihr)",
            "content": [
                { "type": "text", "content": "Sihr (Arabic: سحر) refers to ..." },
                { "type": "arabic", "content": "وَاتَّبَعُوا مَا تَتْلُو الشَّيَاطِينُ ..." },
                { "type": "translation", "content": "And they followed what the devils ..." },
                { "type": "header", "content": "Types of Black Magic" },
                { "type": "text", "content": "Scholars have categorised sihr into ..." }
            ]
        },
        // ... all 26 articles in this topic
    ]
}

Content block types:
text — regular paragraph in the target language | arabic — Arabic script, always kept as-is | translation — translation of the preceding Arabic | header — section heading in the target language | transliteration — phonetic Arabic pronunciation in the target script

7. Get a Specific Topic Article by ID

Returns a single article from the specified topic. Article IDs start from 1 within each topic.

Request

GET https://islamicapi.com/api/v1/ruqyah/?type=topic&lang=en&topic=introduction-to-ruqyah&id=1&api_key={YOUR_API_KEY}

JSON Response (success)

{
    "status": "success",
    "message": "Topic article fetched successfully",
    "data": {
        "sub_id": 1,
        "title": "Ruqyah Shariah in Islam - Quranic Healing for Evil Eye & Magic",
        "section_title": "What is Ruqyah?",
        "category": "Introduction to Ruqyah",
        "content": [
            { "type": "text", "content": "'Ruqyah' is the practice of treating illnesses through Qur'anic ayat ..." },
            { "type": "arabic", "content": "وَنُنَزِّلُ مِنَ الْقُرْآنِ مَا هُوَ شِفَاءٌ ..." },
            { "type": "translation", "content": "\"We send down in the Qur'an that which is a cure and a mercy for the believers.\" (17:82)" },
            { "type": "text", "content": "As well providing a cure, Ruqyah is an excellent way ..." }
        ]
    }
}

8. Get Supported Languages

Returns the complete list of 53 supported languages. The lang parameter is not required for this request type.

Request

GET https://islamicapi.com/api/v1/ruqyah/?type=language&api_key={YOUR_API_KEY}

JSON Response (success)

{
    "status": "success",
    "message": "Languages fetched successfully",
    "data": {
        "am": { "name": "አማርኛ", "name_en": "Amharic" },
        "ar": { "name": "العربية", "name_en": "Arabic" },
        "az": { "name": "Azərbaycan", "name_en": "Azerbaijani" },
        "bn": { "name": "বাংলা", "name_en": "Bengali" },
        "de": { "name": "Deutsch", "name_en": "German" },
        "en": { "name": "English", "name_en": "English" },
        "es": { "name": "Español", "name_en": "Spanish" },
        "fa": { "name": "فارسی", "name_en": "Persian" },
        "fr": { "name": "Français", "name_en": "French" },
        "hi": { "name": "हिन्दी", "name_en": "Hindi" },
        "id": { "name": "Bahasa Indonesia", "name_en": "Indonesian" },
        "tr": { "name": "Türkçe", "name_en": "Turkish" },
        "ur": { "name": "اردو", "name_en": "Urdu" },
        "zh": { "name": "中文", "name_en": "Chinese" }
        // ... all 53 languages
    }
}

Audio Recitations

Audio files for the Ruqyah recitations are served as static MP3 files. They are not part of the JSON API response — you access them directly via URL.

Download all audio files (ZIP):
Download the complete audio pack and extract it into your audio/ folder:

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

Individual Audio File URLs

Access single MP3 files directly by filename:

Quranic Surah Recitations

// Surah Al-Fatiha (1)
https://islamicapi.com/audio/ruqyah/1.mp3

// Surah Al-Baqarah (2)
https://islamicapi.com/audio/ruqyah/2.mp3

// Surah Al-A'raf (7)
https://islamicapi.com/audio/ruqyah/7.mp3

// Surah Ta-Ha (20)
https://islamicapi.com/audio/ruqyah/20.mp3

// Surah Al-Kafirun (109)
https://islamicapi.com/audio/ruqyah/109.mp3

// Surah Al-Ikhlas (112)
https://islamicapi.com/audio/ruqyah/112.mp3

// Surah Al-Falaq (113)
https://islamicapi.com/audio/ruqyah/113.mp3

// Surah An-Nas (114)
https://islamicapi.com/audio/ruqyah/114.mp3

// Ayatul Kursi
https://islamicapi.com/audio/ruqyah/Ayatul Kursi.mp3

Full Program Recitations

// Complete Brief Ruqyah recitation
https://islamicapi.com/audio/ruqyah/total_brief_ruqyah.mp3

// Complete Medium Ruqyah recitation
https://islamicapi.com/audio/ruqyah/total_med_ruqyah.mp3

// Complete Long Ruqyah recitation
https://islamicapi.com/audio/ruqyah/total_long_ruqyah.mp3

Error Responses

All error responses share the same envelope format with an HTTP-style code, status: "error", and a human-readable message.

401 — Missing or invalid API key

{
    "code": 401,
    "status": "error",
    "message": "Unauthorized: API key is required"
}

400 — Missing or invalid type

{
    "code": 400,
    "status": "error",
    "message": "Invalid type \"xyz\". Allowed values: instant-category, instant, topic-category, topic, language"
}

400 — Missing program or invalid program

{
    "code": 400,
    "status": "error",
    "message": "Invalid program \"xyz\". Allowed values: brief-ruqya, a-medium-ruqya, a-long-ruqya"
}

400 — Missing source or invalid source

{
    "code": 400,
    "status": "error",
    "message": "Invalid source \"xyz\". Allowed values: from-quran, from-sunnah"
}

400 — Invalid topic slug

{
    "code": 400,
    "status": "error",
    "message": "Invalid topic \"xyz\". Allowed values: introduction-to-ruqyah, protect-yourself-from-jinn, ..."
}

400 — Unsupported language code

{
    "code": 400,
    "status": "error",
    "message": "Language code \"xyz\" is not available. Please send us a request to add your language."
}

400 — Invalid id format

{
    "code": 400,
    "status": "error",
    "message": "Invalid id. It must be a positive integer."
}

404 — Entry not found

{
    "code": 404,
    "status": "error",
    "message": "Entry #99 not found for program \"brief-ruqya\", source \"from-quran\", language \"en\""
}

Data Source & Feedback

Open Data — Free to Download

The full Ruqyah dataset powering this API is publicly available on GitHub. It includes 308 Ruqyah recitations, 146 topic articles, and translations in 53 languages — all in structured JSON format, completely free for any use.

github.com/islamicapi/ruqyah

Found an Issue?

If you notice incorrect translations, missing data, audio problems, or unexpected API behaviour — open a pull request or issue on GitHub, or reach us directly. Contributions help maintain authenticity and accuracy for everyone.

WhatsApp support@islamicapi.com Contribute on GitHub

Ruqyah API

Base Request

Query Parameters

type required

lang required*

program required for instant

source required for instant

topic required for topic

id optional

random optional

1. Get Instant Ruqyah Categories

Request

2. Get All Ruqyah Entries (a program + source)

Request

3. Get a Specific Ruqyah Entry by ID

Request

4. Get a Random Ruqyah Entry

Request

5. Get Topic Categories

Request

6. Get All Articles in a Topic

Request

7. Get a Specific Topic Article by ID

Request

8. Get Supported Languages

Request

Audio Recitations

Individual Audio File URLs

Error Responses

Data Source & Feedback

Open Data — Free to Download

Found an Issue?

`type` required

`lang` required*

`program` required for instant

`source` required for instant

`topic` required for topic

`id` optional

`random` optional