API Pencarian Vektor Al-Quran
API publik untuk pencarian semantik Al-Quran menggunakan AI dan vector embeddings. Cari dengan bahasa natural!
Tentang Vector Search API
API pencarian cerdas yang memahami konteks dan makna pertanyaan Anda, bukan hanya kata kunci
Apa itu Vector Search?
Vector Search adalah teknologi pencarian berbasis AI yang memahami makna dan konteks dari pertanyaan Anda, bukan hanya mencocokkan kata kunci. Ini memungkinkan pencarian yang lebih akurat dan relevan.
❌ Pencarian Biasa
Query: "cara bersabar"
Hanya menemukan teks yang mengandung kata "sabar" persis
✅ Vector Search
Query: "cara bersabar"
Menemukan ayat tentang kesabaran, ketabahan, dan ujian - meski tidak ada kata "sabar"
Endpoint Pencarian
Endpoint utama untuk pencarian semantik (hanya POST)
POST /api/vector{
"query": "ayat tentang sabar",
"limit": 10,
"types": ["ayat", "tafsir"],
"minScore": 0.5
}GET /api/vectorMenampilkan dokumentasi dan info API
Fitur API
Keunggulan Vector Search API
Pemahaman Semantik:
- • Memahami konteks dan makna pertanyaan
- • Pencarian bahasa natural (Indonesia/Arab)
- • Skor kemiripan untuk relevansi
Data Lengkap:
- • 114 Surah dengan deskripsi
- • 6,236 Ayat dengan terjemahan
- • Tafsir lengkap setiap ayat
- • Koleksi doa dan dzikir
Parameter API
Semua parameter yang tersedia untuk endpoint search
| Parameter | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| cari | string | Ya | - | Pertanyaan atau kata kunci pencarian |
| batas | number | Tidak | 5 | Jumlah hasil (maks: 10) |
| tipe | array | Tidak | semua | Filter: surat, ayat, tafsir, doa |
| skorMin | number | Tidak | 0 | Skor kemiripan minimum (0-1) |
Jenis Data yang Dapat Dicari
Gunakan parameter tipe untuk memfilter hasil
Nama surat, arti, deskripsi, tempat turun, jumlah ayat
Teks Arab, Latin, terjemahan Indonesia & Inggris
Penjelasan dan interpretasi setiap ayat Al-Quran
Koleksi doa dengan teks Arab, Latin, arti, dan sumber
Batas Request
Response header X-RateLimit-Remaining menunjukkan sisa request yang tersedia.
Testing Interaktif
Test Vector Search API secara langsung
Coba semantic search secara real-time. Masukkan pertanyaan dalam bahasa natural untuk melihat hasilnya.
/vector
Pencarian semantik dengan JSON body
curl -X POST "https://equran.id/api/vector" \
-H "Content-Type: application/json" \
-d '{}'💡 Contoh Query yang Bagus
- • "ayat tentang berbakti kepada orang tua"
- • "doa sebelum tidur"
- • "hukum riba dalam Islam"
- • "kisah Nabi Musa"
- • "keutamaan bulan Ramadhan"
Contoh Respons
Format respons dari Vector Search API
{
"status": "sukses",
"cari": "ayat tentang sabar",
"jumlah": 5,
"hasil": [
{
"tipe": "ayat",
"skor": 0.8542,
"relevansi": "tinggi",
"data": {
"id_surat": 2,
"nama_surat": "Al-Baqarah",
"nama_surat_arab": "البقرة",
"nomor_ayat": 153,
"teks_arab": "يَا أَيُّهَا الَّذِينَ آمَنُوا اسْتَعِينُوا بِالصَّبْرِ وَالصَّلَاةِ...",
"teks_latin": "Yaa ayyuhal ladziina aamanustai'iinuu bish-shabri wash-shalaah...",
"terjemahan_id": "Wahai orang-orang yang beriman! Mohonlah pertolongan (kepada Allah) dengan sabar dan salat..."
}
},
{
"tipe": "tafsir",
"skor": 0.7821,
"relevansi": "sedang",
"data": {
"id_surat": 2,
"nama_surat": "Al-Baqarah",
"nomor_ayat": 153,
"isi": "Ayat ini mengajarkan bahwa sabar dan salat adalah dua senjata utama..."
}
}
]
}Contoh Penggunaan
Ide penggunaan Vector Search API
🤖 Chatbot Islam
Integrasikan dengan LLM untuk membuat chatbot yang menjawab pertanyaan dengan referensi Al-Quran
📱 Aplikasi Quran
Tambahkan fitur pencarian cerdas di aplikasi Al-Quran Anda
📚 Platform Pendidikan
Bantu siswa menemukan ayat yang relevan untuk pembelajaran
🔍 Alat Riset
Temukan ayat-ayat terkait untuk penelitian atau kajian tematik