Amanahagent

Amanah Sunnah API

The most comprehensive Islamic knowledge API following the methodology of Ahlus Sunnah wal Jamaah (Salaf). Data Coverage 6,236 Quran verses with Tafsir Ibn…

Media & content#books

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The most comprehensive Islamic knowledge API following the methodology of Ahlus Sunnah wal Jamaah (Salaf).

Data Coverage

  • 6,236 Quran verses with Tafsir Ibn Kathir
  • 36,390 Hadith from 7 major collections (Kutub Sittah + Muwatta Malik)
  • 18,298 Narrators from Taqrib At-Tahdzib
  • 66 Chapters of Kitab At-Tawhid
  • 97 Daily Sunnah practices
  • 50 Duas from authentic hadith
  • 99 Asmaul Husna (Names of Allah)
  • 42 Hadith Nawawi

Features

  • Hybrid semantic search (pgvector + BM25)
  • AI-powered Q&A with RAG from 67,458+ verified references
  • Kajian webhook for YouTube video transcription & AI summarization
  • Hadith grading from Shaykh Al-Albani, Ahmad Shakir, Zubair Ali Zai

Authentication

All endpoints require an API key via X-API-Key header.
Get your free key at Developer Portal.

Rate Limits

  • 60 requests/minute
  • 10,000 requests/day

Completely free. No paid tiers. API key is for identification and abuse prevention only.
Exceeding limits returns 429 Too Many Requests.

Methodology

All data follows the understanding of the Salafus Shalih. No AI-generated content in the knowledge base. Hadith grading from recognized muhaddithin only.

Endpoints 20

Quran & Tafsir

  • GETGet Quran ayah/quran/:keyGet Quran verse with Arabic text (Uthmani), Indonesian translation, and Tafsir Ibn Kathir.
  • GETGet Tafsir Ibn Kathir for an ayah/tafsir/:key

Hadith

  • GETGet hadith by key/hadith/:keyGet hadith with Arabic text, translation, sanad chain, and grading from muhaddithin.
  • GETSearch hadith narrators/rijal?q=سفيانSearch 18,298 narrators from Taqrib At-Tahdzib with grading and biography.
  • GETGet all 42 Hadith Nawawi/nawawi
  • GETGet known fabricated hadiths/maudhu

Islamic Knowledge

  • GETGet daily duas from hadith/doaReturns 50 authentic duas with Arabic text, transliteration, translation, and source hadith.
  • GETGet sunnah daily practices/amalanReturns list of sunnah amalan (daily practices) with Arabic text, translation, and dalil.
  • GETGet 99 Names of Allah/asmaul-husna
  • GETGet Kitab At-Tawhid chapters/tawhid
  • GETGet Aqidah Salaf explanations/aqidah
  • GETGet Islamic figures/figures
  • GETGet Sunnah calendar events/sunnah-calendarReturns sunnah fasting days, prohibited fasting days, and recommended practices for a given date or month. Includes Hijri date conversion and dalil from…

AI & Search

  • POSTHybrid semantic + keyword search/searchSearch across Quran, Hadith, and Rijal using AI-powered hybrid search (pgvector + BM25).
  • POSTAI Q&A with dalil/askAsk any Islamic question. AI answers with dalil from 67,458 verified references (RAG + Gemini).

Lectures

  • POST[Deprecated] Use /lecture/webhook instead/kajian/webhookDeprecated. Legacy endpoint. Please use /lecture/webhook with English field names.
  • POSTSubmit lecture for AI processing/lecture/webhookSubmit a YouTube lecture URL for transcription and AI summary. Requires admin approval before processing.
  • GETList published Islamic lectures/lectureReturns published lectures with AI-generated summaries, speaker info, topic, duration, and associated mosque.

Community

  • GETList verified Salafi mosques/mosqueReturns all verified mosques following Ahlus Sunnah wal Jama'ah manhaj with location data.
  • GETList verified Salafi schools/schoolReturns all verified schools, madrasah, and pesantren following Salaf manhaj with education level and location.

API details

Base URL
https://sunnah.amanahagent.cloud/api/v1
Authentication
An API key in the X-API-Key header
Operations
20 operations on 20 pathsGET 16POST 4
1 marked deprecated
Main resources
Islamic Knowledge 7Hadith 4Lectures 3AI & Search 2Community 2Quran & Tafsir 2
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.1.0

How to test the Amanah Sunnah API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Amanah Sunnah API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get Quran ayah” (GET /quran/:key), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Amanah Sunnah API?

The most comprehensive Islamic knowledge API following the methodology of Ahlus Sunnah wal Jamaah (Salaf). Data Coverage 6,236 Quran verses with Tafsir Ibn… It is listed under Media & content and has 20 endpoints.

Who publishes the Amanah Sunnah API?

It is listed from Amanahagent's public API description (an OpenAPI document), not published by Amanahagent on Swastik Codes. Anyone who controls sunnah.amanahagent.cloud can claim the profile by adding a DNS TXT record.

What is the base URL of the Amanah Sunnah API?

Requests go to https://sunnah.amanahagent.cloud/api/v1. Endpoint paths are added to this base URL.

How do I authenticate with the Amanah Sunnah API?

With an API key in the X-API-Key header.

How many endpoints does the Amanah Sunnah API have?

20 operations on 20 paths (16 GET, 4 POST). The largest groups are Islamic Knowledge, Hadith, Lectures, AI & Search.

Is forking the Amanah Sunnah API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.