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.

13 Endpoints

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

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`

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}'

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
}

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/maudhu

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

Parameter	Type	Description

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