Islamic Knowledge API

A free REST API providing semantic search and direct access to 67,458+ verified Islamic references. Built on Salaf/Sunnah manhaj with data exclusively from recognized scholarly sources. Designed for developers building Islamic mobile apps, AI chatbots, education platforms, and research tools.

Semantic Search

Natural language queries with intelligent similarity matching and Indonesian stemming fallback.

Verified Sources

Grading from Al-Bukhari, Muslim, Al-Albani. Narrator data from Taqrib At-Tahdzib by Ibn Hajar.

15 Endpoints

Quran, Hadith, Tafsir, Rijal, Tawhid, Aqidah, Amalan, Nawawi, Doa, Asmaul Husna, Figures, Maudhu, Kalender Sunnah.

No Limits

Completely free. No rate limits, no billing, no usage caps. API key for identification only.

Data Coverage

Resource	Records	Endpoint
Quran Verses	6,236	`/quran/:key`
Hadith (7 collections)	36,390	`/hadith/:key`
Tafsir Ibn Kathir	~6,000	`/tafsir/:key`
Rijal Narrators	18,298	`/rijal`
Kitab At-Tawhid	66	`/tawhid`
Aqidah Salaf	60	`/aqidah`
Amalan Sunnah	97	`/amalan`
Hadith Nawawi	42	`/nawawi`
Doa Harian	50	`/doa`
Asmaul Husna	99	`/asmaul-husna`
Islamic Figures	26	`/figures`
Hadith Maudhu	15	`/maudhu`
Masjid Salaf	dynamic	`/mosque`
Sekolah Salaf	dynamic	`/school`
Kajian Salaf	dynamic	`/lecture`
Lecture Webhook	POST	`/lecture/webhook`

Base URL

https://sunnah.amanahagent.cloud/api/v1

Quick Example

Search for hadith about night prayer

curl -X POST https://sunnah.amanahagent.cloud/api/v1/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_sunnah_your_key" \
  -d '{"q": "keutamaan shalat malam", "type": "hadith", "limit": 3}'

Submit Lecture via Webhook

Submit an Islamic lecture YouTube video for admin review and AI processing (transcription + summary).

Submit lecture for AI processing

curl -X POST https://sunnah.amanahagent.cloud/api/v1/lecture/webhook \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_sunnah_your_key" \
  -d '{
    "youtube_url": "https://www.youtube.com/watch?v=xxxxx",
    "title": "Riyadhus Shalihin - Bab Ikhlas",
    "speaker": "Ustadz Fulan",
    "topic": "Aqidah",
    "mosque_name": "MAIS"
  }'

Fields: youtube_url (required), title, speaker, topic, mosque_name, mosque_city

mosque_name: Partial match — "MAIS" matches "Masjid SYAIKH HAMAD AL HAMAD/ IMAM ASY-SYAFI'I (MAIS)"

Response: {"id":"uuid","status":"pending","message":"..."}

Manhaj Salaf — All data follows the understanding of the Salafus Shalih. No deviant interpretations. Hadith grading from recognized muhaddithin. Zero AI-generated content in the knowledge base.

Authentication

All requests require an X-API-Key header. Keys are free and used for identification only.

X-API-Key: sk_sunnah_your_key_here

Generate your key — it will also be sent to your email:

Forgot your key? Resend via email

POST/api/v1/search

Semantic vector search across Quran, Hadith, and Rijal. Uses intelligent similarity matching with automatic fallback to keyword search with Indonesian stemming when confidence is low.

Parameter	Type	Description
`q`*	string	Search query in natural language
`type`	string	"quran" \| "hadith" \| "rijal" — omit to search all
`limit`	number	Max results per type (default: 10, max: 30)

Request

curl -X POST https://sunnah.amanahagent.cloud/api/v1/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_sunnah_your_key" \
  -d '{"q": "keutamaan shalat malam", "type": "hadith", "limit": 5}'

Response

{
  "results": [
    {
      "hadith_key": "bukhari:1160",
      "collection_name": "Sahih al-Bukhari",
      "text_indonesian": "Sebaik-baik shalat setelah shalat wajib adalah shalat malam.",
      "grades": [{"grade": "Sahih", "graded_by": "Al-Bukhari"}],
      "similarity": 0.82,
      "_type": "hadith"
    }
  ],
  "method": "vector",
  "total": 1
}

POST/api/v1/ask

AI-powered Islamic Q&A. Ask any question and receive a comprehensive answer with dalil from Al-Quran and Hadith, following the understanding of the Salafus Shalih. Uses RAG (Retrieval Augmented Generation) with the full knowledge base.

Parameter	Type	Description
`question`*	string	Islamic question in natural language

Request

curl -X POST https://sunnah.amanahagent.cloud/api/v1/ask \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_sunnah_your_key" \
  -d '{"question": "Apa hukum riba dalam Islam?"}'

Response

{
  "question": "Apa hukum riba dalam Islam?",
  "answer": "Bismillahirrahmanirrahim.\n\nRiba hukumnya HARAM...\n\n## Dalil dari Al-Quran\n...",
  "sources": ["2:275", "bukhari:2145", "muslim:1598"]
}

GET/api/v1/quran/{surah}:{ayah}

Retrieve a specific Quran verse. Returns Arabic text in Uthmani script, Indonesian translation, and surah metadata.

Parameter	Type	Description
`key`*	path	Format "surah:ayah" — e.g. 2:255, 36:1, 112:1

Request

curl https://sunnah.amanahagent.cloud/api/v1/quran/2:255 \
  -H "X-API-Key: sk_sunnah_your_key"

Response

{
  "surah_number": 2,
  "surah_name_ar": "البقرة",
  "surah_name_en": "Al-Baqarah",
  "ayah_number": 255,
  "ayah_key": "2:255",
  "text_arabic": "اللَّهُ لَا إِلَٰهَ إِلَّا هُوَ الْحَيُّ الْقَيُّومُ...",
  "text_indonesian": "Allah, tidak ada Tuhan selain Dia, Yang Maha Hidup..."
}

GET/api/v1/hadith/{collection}:{number}

Retrieve a specific hadith by collection and number. Returns full text, scholarly grading, and section metadata.

Parameter	Type	Description
`key`*	path	Format "collection:number" — e.g. bukhari:1, muslim:2699

Available collections: bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah, malik

Request

curl https://sunnah.amanahagent.cloud/api/v1/hadith/bukhari:1 \
  -H "X-API-Key: sk_sunnah_your_key"

Response

{
  "hadith_key": "bukhari:1",
  "collection_name": "Sahih al-Bukhari",
  "hadith_number": 1,
  "text_arabic": "...",
  "text_indonesian": "Sesungguhnya setiap amalan tergantung pada niatnya...",
  "grades": [{"grade": "Sahih", "graded_by": "Al-Bukhari"}],
  "book_number": 1,
  "section_name": "Permulaan Wahyu"
}

GET/api/v1/tafsir/{surah}:{ayah}

Get Tafsir Ibn Kathir for a specific ayah. Returns the tafsir text along with the verse.

Parameter	Type	Description
`key`*	path	Format "surah:ayah" — e.g. 2:255, 1:1

Request

curl https://sunnah.amanahagent.cloud/api/v1/tafsir/2:255 \
  -H "X-API-Key: sk_sunnah_your_key"

Response

{
  "ayah_key": "2:255",
  "surah_name_en": "Al-Baqarah",
  "text_arabic": "اللَّهُ لَا إِلَٰهَ إِلَّا هُوَ...",
  "text_indonesian": "Allah, tidak ada Tuhan selain Dia...",
  "tafsir": "Ini adalah ayat Kursi yang memiliki kedudukan agung..."
}

GET/api/v1/rijal?q={name}

Search 18,298 hadith narrators from Taqrib At-Tahdzib. Returns biographical data, scholarly grade, and tabaqah.

Parameter	Type	Description
`q`*	query	Narrator name (Arabic or transliterated)
`limit`	query	Max results (default: 20, max: 50)

Request

curl "https://sunnah.amanahagent.cloud/api/v1/rijal?q=البخاري&limit=5" \
  -H "X-API-Key: sk_sunnah_your_key"

Response

{
  "results": [
    {
      "name_arabic": "محمد بن إسماعيل البخاري",
      "kuniyah": "أبو عبد الله",
      "nasab": "الجعفي",
      "tabaqah": 11,
      "grade": "ثقة",
      "grade_detail": "حافظ إمام",
      "death_year_hijri": 256
    }
  ],
  "total": 1
}

GET/api/v1/tawhid

All 66 chapters of Kitab At-Tawhid by Muhammad ibn Abdul Wahhab with Quran and Hadith evidence.

Parameter	Type	Description

GET/api/v1/aqidah

60 core aqidah explanations following the Salafus Shalih methodology with scholarly references.

Parameter	Type	Description

GET/api/v1/amalan

97 daily sunnah practices with Arabic, transliteration, translation, benefits, and sahih source.

Parameter	Type	Description
`category`	query	Filter by category_id (e.g. morning-dhikr, evening-dhikr)

GET/api/v1/nawawi

Complete 42 Hadith Nawawi with Arabic text, Indonesian translation, narrator, and grading.

Parameter	Type	Description

GET/api/v1/doa

50 daily duas from sahih sources with Arabic, Latin transliteration, and Indonesian translation.

Parameter	Type	Description
`category`	query	Filter by category (e.g. pagi, sore, tidur, makan)

GET/api/v1/asmaul-husna

The 99 Names of Allah with Arabic, transliteration, meaning, and explanation.

Parameter	Type	Description

GET/api/v1/figures

26 key Islamic figures — companions, scholars, and imams with biographical data.

Parameter	Type	Description

GET/api/v1/sunnah-calendar

Kalender Sunnah — returns sunnah fasting days, prohibited fasting days, and recommended practices for a given date or month. Includes automatic Hijri date conversion and dalil from authentic hadith.

Parameter	Type	Description
`date`	query	Specific date (YYYY-MM-DD). Returns events for that day. Defaults to today.
`month`	query	Month number (1-12). Returns all days with events in that month.
`year`	query	Year (used with month). Defaults to current year.

Event types: puasa_wajib (mandatory fasting), puasa_sunnah (recommended fasting), larangan (fasting prohibited), amalan (recommended practice).

Request — Single date

curl https://sunnah.amanahagent.cloud/api/v1/sunnah-calendar?date=2026-06-11 \
  -H "X-API-Key: sk_sunnah_your_key"

Response — Single date

{
  "date": "2026-06-11",
  "hijri": {
    "year": 1447,
    "month": 12,
    "day": 6,
    "monthName": "Dzulhijjah"
  },
  "dayOfWeek": 4,
  "events": [
    {
      "type": "puasa_sunnah",
      "label": "Puasa Kamis",
      "dalil": "HR. Tirmidzi 745, Nasa'i 2362"
    },
    {
      "type": "puasa_sunnah",
      "label": "10 Hari Terbaik — Perbanyak Takbir & Amal Shalih",
      "dalil": "HR. Bukhari 969"
    }
  ]
}

Request — Full month

curl https://sunnah.amanahagent.cloud/api/v1/sunnah-calendar?month=6&year=2026 \
  -H "X-API-Key: sk_sunnah_your_key"

Response — Full month (truncated)

{
  "year": 2026,
  "month": 6,
  "total": 22,
  "days": [
    {
      "date": "2026-06-01",
      "hijri": { "year": 1447, "month": 12, "day": 1, "monthName": "Dzulhijjah" },
      "dayOfWeek": 1,
      "events": [
        { "type": "puasa_sunnah", "label": "Puasa Senin", "dalil": "HR. Muslim 1162" },
        { "type": "puasa_sunnah", "label": "10 Hari Terbaik — Perbanyak Takbir & Amal Shalih", "dalil": "HR. Bukhari 969" }
      ]
    },
    {
      "date": "2026-06-05",
      "hijri": { "year": 1447, "month": 12, "day": 5, "monthName": "Dzulhijjah" },
      "dayOfWeek": 5,
      "events": [
        { "type": "amalan", "label": "Jumat — Baca Al-Kahfi & Perbanyak Shalawat", "dalil": "HR. Muslim 879, Abu Dawud 1047" },
        { "type": "puasa_sunnah", "label": "10 Hari Terbaik — Perbanyak Takbir & Amal Shalih", "dalil": "HR. Bukhari 969" }
      ]
    }
  ]
}

GET/api/v1/maudhu

15 commonly circulated fabricated hadith with scholar rulings and correct alternatives from sahih sources.

Parameter	Type	Description

GET/api/v1/mosque

List all verified Salafi mosques (following Ahlus Sunnah wal Jama'ah manhaj). Returns name, location coordinates, city, and address. Useful for building mosque finder apps.

Parameter	Type	Description
`q`	query	Search by name or city (case-insensitive, min 2 chars)
`lat`	query	Latitude for proximity search
`lng`	query	Longitude for proximity search

Request

curl "https://sunnah.amanahagent.cloud/api/v1/mosque" \
  -H "X-API-Key: sk_sunnah_your_key"

Response

{
  "mosques": [
    {
      "id": "uuid",
      "name": "Masjid Al-Ikhlas",
      "address": "Jl. Raya No. 1",
      "city": "Jakarta",
      "lat": -6.2088,
      "lng": 106.8456,
      "phone": "021-1234567"
    }
  ],
  "total": 150
}

GET/api/v1/school

List all verified Salafi schools (schools, madrasah, pesantren following Salaf manhaj). Returns name, location, education level, and curriculum type.

Parameter	Type	Description
`q`	query	Search by name or city (case-insensitive, min 2 chars)
`level`	query	"TK" \| "SD" \| "SMP" \| "SMA" \| "Pesantren"
`lat`	query	Latitude for proximity search
`lng`	query	Longitude for proximity search

Request

curl "https://sunnah.amanahagent.cloud/api/v1/school?level=Pesantren" \
  -H "X-API-Key: sk_sunnah_your_key"

Response

{
  "schools": [
    {
      "id": "uuid",
      "name": "Pesantren Al-Furqan",
      "address": "Jl. Pesantren No. 5",
      "city": "Bogor",
      "lat": -6.5971,
      "lng": 106.8060,
      "phone": "0251-123456",
      "website": "https://alfurqan.sch.id",
      "educationLevel": "SD, SMP, SMA, Pesantren",
      "curriculumType": "pesantren"
    }
  ],
  "total": 25
}

GET/api/v1/lecture

List published Islamic lectures with AI-generated summaries. Returns YouTube URL, speaker name, topic, duration, and associated mosque.

Parameter	Type	Description
`q`	query	Search by title, speaker, or topic
`topic`	query	Filter by topic (Aqidah, Fiqh, Tafsir, etc.)
`limit`	query	Max results (default: 20, max: 50)
`page`	query	Page number for pagination (default: 1)

Request

curl "https://sunnah.amanahagent.cloud/api/v1/lecture?topic=Aqidah&limit=5" \
  -H "X-API-Key: sk_sunnah_your_key"

Response

{
  "lectures": [
    {
      "id": "uuid",
      "title": "Syarah Kitab At-Tauhid - Bab 1",
      "youtubeUrl": "https://www.youtube.com/watch?v=xxxxx",
      "speaker": "Ustadz Fulan",
      "topic": "Aqidah",
      "duration": 3600,
      "summary": "AI-generated summary of the lecture...",
      "createdAt": "2026-05-01T00:00:00Z",
      "mosque": {
        "name": "Masjid Al-Ikhlas",
        "city": "Jakarta"
      }
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 5
}

Embeddable Chat Widget

Add an Islamic Q&A chatbot to any website with a single script tag. Users can ask questions and get answers with dalil directly on your site.

Add to your HTML

<script src="https://sunnah.amanahagent.cloud/widget.js" data-key="sk_sunnah_your_key"></script>

How it works:

• Adds a floating chat button (bottom-right) to your website
• Users type a question → calls your API key → returns AI answer with dalil
• No dependencies, no framework required — works on any HTML page
• Styled with inline CSS, won't conflict with your site styles

Replace sk_sunnah_your_key with your actual API key.

Knowledge Base

Complete dataset accessible through the search endpoint.

Al-QuranMushaf Uthmani + Kemenag RI translation

6,236

Sahih al-BukhariImam al-Bukhari (d. 256H)

7,563

Sahih MuslimImam Muslim (d. 261H)

7,453

Sunan Abu DawudAbu Dawud (d. 275H)

5,274

Jami at-TirmidhiAt-Tirmidhi (d. 279H)

3,956

Sunan an-Nasa'iAn-Nasa'i (d. 303H)

5,758

Sunan Ibn MajahIbn Majah (d. 273H)

4,341

Muwatta MalikImam Malik (d. 179H)

1,858

Tafsir Ibn KathirPer-ayah tafsir in Indonesian

~6,000

Rijal NarratorsTaqrib At-Tahdzib, Ibn Hajar

18,298

Kitab At-TawhidMuhammad ibn Abdul Wahhab

Aqidah SalafCore aqidah explanations

Amalan SunnahDaily practices with dalil

Doa HarianDuas from sahih sources

Asmaul Husna99 Names of Allah

Error Handling

All errors return JSON with an error field.

Status	Meaning
401	Missing or invalid API key
400	Missing required parameters
404	Resource not found (invalid key format)

Error Response

{
  "error": "Missing X-API-Key header",
  "docs": "https://sunnah.amanahagent.cloud/developers"
}

API Sandbox

API Key

Endpoint

Search Query

Type (optional)

Response

Response will appear here