HouseMuslim
Referensi API

Hadis

Sembilan kitab hadis (Kutubut Tis'ah) — daftar kitab, jelajah per nomor, dan pencarian teks Arab/Indonesia. Publik dan hanya-baca.

Semua endpoint hadis berada di bawah /api/v1/hadith dan bersifat publik. Konten disajikan dari berkas JSON yang sama dengan engine (self-hosted, tanpa basis data) dan dapat di-cache hingga 24 jam.

Kitab yang tersedia (slug): bukhari, muslim, abu-dawud, tirmidzi, nasai, ibnu-majah, ahmad, malik, darimi — total 38.102 hadis (teks Arab + terjemahan Indonesia).

Daftar kitab

GET /hadith/books
GET/hadith/booksLangsung
GET /hadith/books
curl "https://api.housemuslim.org/api/v1/hadith/books"
const res = await fetch('https://api.housemuslim.org/api/v1/hadith/books');
const { data } = await res.json();
console.log(data[0].name, data[0].total); // Shahih Bukhari 6638
{
  "success": true,
  "data": [
    { "slug": "bukhari", "name": "Shahih Bukhari", "name_arabic": "صحيح البخاري", "total": 6638, "sort_order": 1 },
    { "slug": "muslim", "name": "Shahih Muslim", "name_arabic": "صحيح مسلم", "total": 4930, "sort_order": 2 }
  ]
}

Detail satu kitab tersedia di GET /hadith/books/{slug}.

Jelajah hadis

GET /hadith/books/{slug}/items

Mengembalikan hadis pada satu kitab, dengan paginasi.

ParamTypeDefaultDeskripsi
pageint1Halaman
per_pageint20Item per halaman (maks. 50)
GET/hadith/books/{slug}/itemsLangsung
GET /hadith/books/bukhari/items?page=1&per_page=5
curl "https://api.housemuslim.org/api/v1/hadith/books/bukhari/items?page=1&per_page=2"
{
  "success": true,
  "data": [
    {
      "book": "bukhari",
      "number": 1,
      "arab": "حَدَّثَنَا الْحُمَيْدِيُّ عَبْدُ اللَّهِ بْنُ الزُّبَيْرِ …",
      "translation_id": "Telah menceritakan kepada kami Al Humaidi Abdullah bin Az Zubair …"
    }
  ],
  "meta": { "page": 1, "per_page": 2, "total": 6638 }
}

Detail satu hadis

GET /hadith/books/{slug}/items/{number}
curl "https://api.housemuslim.org/api/v1/hadith/books/muslim/items/1"
{
  "success": true,
  "data": {
    "book": "muslim",
    "number": 1,
    "arab": "حَدَّثَنِي أَبُو خَيْثَمَةَ زُهَيْرُ بْنُ حَرْبٍ …",
    "translation_id": "Telah menceritakan kepadaku Abu Khaitsamah Zuhair bin Harb …"
  }
}

Pencarian

GET /hadith/books/{slug}/search

Mencari di dalam satu kitab — cocokkan substring pada teks Arab atau terjemahan Indonesia (tidak peka huruf besar untuk terjemahan).

ParamTypeDefaultDeskripsi
qstring— (wajib)Kata kunci
pageint1Halaman
per_pageint20Item per halaman (maks. 50)
GET/hadith/books/{slug}/searchLangsung
GET /hadith/books/bukhari/search?q=niat&per_page=5
curl "https://api.housemuslim.org/api/v1/hadith/books/bukhari/search?q=niat&per_page=5"
FieldArti
bookSlug kitab
numberNomor hadis dalam kitab
arabTeks Arab
translation_idTerjemahan Indonesia

Pencarian dilingkup per kitab (parameter slug wajib). Untuk mencari lintas kitab, panggil tiap kitab lalu gabungkan hasilnya di sisi klien.

Di halaman ini