SÜNNETİMİZSÜNNET VE HADİS KÜTÜPHANESİ

API & Bilgi

Sünnetimiz hadis kütüphanesini kendi web sitenize, uygulamanıza veya botunuza bağlayın. Ücretsiz, anahtar gerektirmez, herkese açık JSON. Sahih-i Buhari, Sahih-i Müslim, Kütüb-i Sitte ve diğer kaynaklar; Arapça metin, Türkçe meal, dereceler ve arama.

English: free, keyless, read-only JSON API for Arabic hadith text with Turkish translations, grades, chapters and full-text search. CORS enabled. OpenAPI 3.1 spec and llms.txt available below.

Hemen deneYapay zekâ için istemopenapi.jsonllms.txtToplu veri talebi

Hızlı başlangıç

Temel adres https://sunnetimiz.com/api/v1. Yalnızca GET; yanıtlar UTF-8 JSON, CORS açık — doğrudan tarayıcıdan da çağırabilirsiniz.

cURL
curl "https://sunnetimiz.com/api/v1/hadith/buhari:1"
JavaScript
const r = await fetch("https://sunnetimiz.com/api/v1/search?q=niyet&book=buhari&limit=5");
const { results } = await r.json();
for (const h of results) {
  console.log(h.ref, h.turkish);   // "buhari:1" + Türkçe meal
}
// Her hadisin yanında: Kaynak: Sünnetimiz.com
Python
import requests

r = requests.get("https://sunnetimiz.com/api/v1/random", timeout=10)
h = r.json()
print(h["ref"], "-", h["turkish"])
print(h["arabic"])
print(h["meta"]["attribution"])   # Kaynak: Sünnetimiz.com

Canlı dene

Aşağıdaki kutu gerçek API’yi çağırır. Bir örneğe tıklayın veya kendi yolunuzu yazın.

GET https://sunnetimiz.com/api/v1

Yapay zekâ ile kullanın

ChatGPT, Claude, Cursor vb. ile uygulama yaptırıyorsanız aşağıdaki istemi yapıştırın ve sonuna ne istediğinizi yazın. Yapay zekâ OpenAPI şemasını ve llms.txt dosyasını okuyarak doğru çağrıları kendisi yazar.

Sünnetimiz.com'un ücretsiz hadis API'sini kullanan bir uygulama yaz.

API belgeleri (OpenAPI 3.1): https://sunnetimiz.com/api/v1/openapi.json
Kısa özet (LLM için): https://sunnetimiz.com/llms.txt
Base URL: https://sunnetimiz.com/api/v1 — anahtar gerekmez, CORS açık, yalnızca GET.

Uç noktalar: /books, /books/{slug}, /books/{slug}/kitabs/{n}?page=&limit=, /hadith/{slug}:{no}?isnad=1, /search?q=&lang=&book=&limit=&page=, /random
Limitler: dakikada 60 / günde 3000 istek (arama dakikada 20). 429 gelirse Retry-After başlığını bekle; yanıtları önbelleğe al.
Kurallar: her hadisin yanında "Kaynak: Sünnetimiz.com" (bağlantılı) göster; metni değiştirme; isnad/râvî bilgisinin doğrulanmamış olduğunu belirt.

Yapmak istediğim:

Örnek son cümleler: “…günün hadisini gösteren bir WhatsApp botu.” · “…hadis arama sayfası (Türkçe ve Arapça).” · “…kitap ve kitâb gezinen mobil uygulama.”

Uç noktalar

GET/books
Kitap listesi

Tüm kitaplar: hadis sayısı, kitâb sayısı ve durum (full = Türkçe meal + Arapça, arabic_only = yalnızca Arapça).

https://sunnetimiz.com/api/v1/books
GET/books/{slug}
Kitap ve kitâb listesi

Tek bir kitap ve içindeki kitâb (bölüm) listesi.

ParametreNeredeAçıklama
slug*yolKitap kısa adı (bkz. /books)
https://sunnetimiz.com/api/v1/books/buhari
GET/books/{slug}/kitabs/{n}
Kitâb içindeki hadisler

Bir kitâbın hadisleri, sayfalandırılmış (Türkçe, Arapça, derece, bâb).

ParametreNeredeAçıklama
slug*yolKitap kısa adı
n*yolKitâb numarası
pagesorguSayfa numarası (varsayılan 1)
limitsorguSayfa başına hadis (1–100) (varsayılan 50)
https://sunnetimiz.com/api/v1/books/buhari/kitabs/2?limit=5
GET/hadith/{slug}:{number}
Tek hadis

Bir hadisin Türkçe meali, Arapça metni, derecesi, kitâb ve bâb bilgisi; önceki/sonraki bağlantıları.

ParametreNeredeAçıklama
ref*yolkitap:numara biçiminde
isnadsorgu1 verilirse râvî zincirinin adları (Türkçe okunuşu + Arapça) eklenir. Otomatik çıkarılmıştır, doğrulanmamıştır.
https://sunnetimiz.com/api/v1/hadith/buhari:1?isnad=1
GET/random
Rastgele hadis

Türkçe mealli rastgele bir hadis — “günün hadisi” bileşenleri için.

ParametreNeredeAçıklama
booksorguİsteğe bağlı kitap kısa adı
https://sunnetimiz.com/api/v1/random

Kitap kısa adları (slug) için /books yanıtına bakın: buhari, muslim, ebudavud, tirmizi, nesai, ibnmace, malik, ahmed, …

Yanıt örneği

Bir hadis nesnesi (kısaltılmıştır). Yalnızca-Arapça kitaplarda turkish alanı null gelir.

{
  "ref": "buhari:1",
  "url": "https://sunnetimiz.com/buhari:1",
  "book": { "slug": "buhari", "name": "Sahih-i Buhari", "name_ar": "صحيح البخاري" },
  "kitab": { "number": 1, "title": "Vahyin Başlangıcı", "title_ar": "كتاب بدء الوحي" },
  "bab": { "number": 1, "title_ar": "باب: كَيْفَ كَانَ بَدْءُ الْوَحْيِ إِلَى رَسُولِ اللَّهِ ﷺ" },
  "number": "1",
  "turkish": "Alkame b. Vakkâs el-Leysî'den: O şöyle demiştir: Ömer İbnu'l-Hattâb'ın minberde şöyle dediğini duydum: ...",
  "arabic": "حَدَّثَنَا الْحُمَيْدِيُّ عَبْدُ اللَّهِ بْنُ الزُّبَيْرِ ، ...",
  "grade": { "label": "Sahih", "by": "Buhârî'nin Sahîh'i", "tone": "sahih" },
  "meta": { "source": "Sünnetimiz.com", "attribution": "Kaynak: Sünnetimiz.com" }
}

Hata durumunda: { "error": { "code": "hadith_not_found", "message": "…" } } ve uygun HTTP kodu (400, 404, 429, 500).

Limitler ve kurallar

Herkesin rahatça kullanabilmesi ve sitenin yavaşlamaması için makul, cömert sınırlar uyguluyoruz:

Dakika başına60 istek (IP başına)
Gün başına3.000 istek (IP başına)
Aramadakikada 20 istek
Sayfa boyutuen fazla 100 hadis (arama: 50)
Arama sayfasıen fazla 20 sayfa

Tüm veriyi isteyin

Tüm hadisleri (ör. kendi veritabanınız için) API’den çekmenize gerek yok: talebinizi e-posta ile gönderin, veriyi elle JSON/SQLite olarak size iletelim. Bu bir bağış değil, kaynak göstermeye ve amaca bağlı bir izindir; talebi inceleyip döneceğiz.

Talep e-postası oluştur[email protected]

Verileri nereden aldık?

Şeffaflık için tüm kaynaklarımız. Bir hata görürseniz kitaplarda “Düzelt” düğmesiyle bildirebilirsiniz.

Türkçe meallerin çevirmenleri

Türkçe metinler aşağıdaki yayımlanmış çevirilerdir (künyeler Darul Kitap / İslami Okul sürümlerinden alınmıştır). Bu eserlerin hakları çevirmenlere ve yayınevlerine aittir; Sünnetimiz bunları kendi çevirisi olarak sunmaz.

KitapÇevirmenYayınevi
Sahih-i BuhariMehmed SofuoğluÖtüken Neşriyat
Sahih-i MüslimAhmed DavudoğluSönmez Neşriyat
Sünen-i Ebû DâvûdNecati Yeniel – Hüseyin KayapınarŞamil Yayınevi (İstanbul)
Sünen-i TirmizîAbdullah ParlıyanKonya Kitapçılık (2004)
Sünen-i NesâîAbdullah ParlıyanKonya Kitapçılık
Sünen-i İbn MâceHaydar HatîpoğluKahraman Yayınları
Muvatta (İmam Mâlik)Ahmet BüyükpınarBeyan Yayınları
Riyâzü’s-SâlihînAbdullah ParlıyanKonya Kitapçılık

Müslim künyesi dolaylı olarak çıkarılmıştır (Tirmizî çevirisinin önsözündeki yayınevi listesi ve metindeki “Ahmed Davudoğlu şerhi” bağlantıları). Sünnetimiz çevirmen/editörleri, Selef-i Sâlihîn anlayışına aykırı gördükleri ifadeleri panelden düzeltebilir; düzeltilen hadislerde metin artık orijinal çeviriden farklı olabilir.

Diğer kaynaklar

Sorular, öneriler veya hata bildirimi için: [email protected] · ← Ana sayfa