API Developer v1.0
API versi pertama untuk mengakses data Al-Quran dengan format response sederhana. Cocok untuk proyek legacy atau yang membutuhkan struktur data minimal.
Data Lengkap
114 surat, 6236 ayat dengan terjemahan Indonesia
RESTful API
API standar REST yang mudah diintegrasikan
Gratis
Tidak ada biaya, rate limit yang wajar
JSON Response
Format JSON yang mudah di-parse
Base URL
https://equran.id/api
Available Endpoints
GET/api/surat
Mendapatkan daftar semua surat dalam Al-Quran
Response
Array dari objek surat dengan informasi lengkap
Contoh Response
[
{
"nomor": 1,
"nama": "الفاتحة",
"nama_latin": "Al-Fatihah",
"jumlah_ayat": 7,
"tempat_turun": "mekah",
"arti": "Pembukaan",
"deskripsi": "Surat Al Faatihah (Pembukaan) yang diturunkan di Mekah dan terdiri dari 7 ayat adalah surat yang pertama-tama diturunkan dengan lengkap diantara surat-surat yang ada dalam Al Quran dan termasuk golongan surat Makkiyyah. Surat ini disebut Al Faatihah (Pembukaan), karena dengan surat inilah dibuka dan dimulainya Al Quran. Dinamakan Ummul Quran (induk Al Quran) atau Ummul Kitaab (induk Al Kitaab) karena dia merupakan induk dari semua isi Al Quran, dan karena itu diwajibkan membacanya pada tiap-tiap sembahyang.
Dinamakan pula As Sab'ul matsaany (tujuh yang berulang-ulang) karena ayatnya tujuh dan dibaca berulang-ulang dalam sholat.",
"audio": "https://equran.nos.wjv-1.neo.id/audio-full/Misyari-Rasyid-Al-Afasi/001.mp3"
}
]
GET/api/surat/{id}
Mendapatkan detail surat beserta ayat-ayatnya
Response
Objek surat lengkap dengan array ayat
Contoh Response
{
"nomor": 1,
"nama": "الفاتحة",
"nama_latin": "Al-Fatihah",
"jumlah_ayat": 7,
"tempat_turun": "mekah",
"arti": "Pembukaan",
"deskripsi": "Surat Al Faatihah (Pembukaan) yang diturunkan di Mekah dan terdiri dari 7 ayat adalah surat yang pertama-tama diturunkan dengan lengkap diantara surat-surat yang ada dalam Al Quran dan termasuk golongan surat Makkiyyah. [...]",
"audio": "https://equran.nos.wjv-1.neo.id/audio-full/Misyari-Rasyid-Al-Afasi/001.mp3",
"ayat": [
{
"id": 1,
"surah": 1,
"nomor": 1,
"ar": "بِسْمِ اللّٰهِ الرَّحْمٰنِ الرَّحِيْمِ",
"tr": "bismillāhir-raḥmānir-raḥīm(i).",
"idn": "Dengan nama Allah Yang Maha Pengasih, Maha Penyayang."
}
],
"status": true
}
GET/api/tafsir/{id}
Mendapatkan tafsir untuk surat tertentu
Response
Objek surat dengan array tafsir per ayat
Contoh Response
{
"status": true,
"nomor": 1,
"nama": "الفاتحة",
"nama_latin": "Al-Fatihah",
"jumlah_ayat": 7,
"tempat_turun": "mekah",
"arti": "Pembukaan",
"deskripsi": "Surat Al Faatihah (Pembukaan) yang diturunkan di Mekah dan terdiri dari 7 ayat adalah surat yang pertama-tama diturunkan dengan lengkap diantara surat-surat yang ada dalam Al Quran dan termasuk golongan surat Makkiyyah. [...]",
"audio": "https://equran.nos.wjv-1.neo.id/audio-full/Misyari-Rasyid-Al-Afasi/001.mp3",
"tafsir": [
{
"id": 1,
"surah": 1,
"ayat": 1,
"tafsir": "Surah al-Fatihah dimulai dengan Basmalah
Ada beberapa pendapat ulama berkenaan dengan Basmalah yang terdapat pada permulaan surah Al-Fatihah. [...]"
}
],
"surat_selanjutnya": {
"id": 2,
"nomor": 2,
"nama": "البقرة",
"nama_latin": "Al-Baqarah",
"jumlah_ayat": 286,
"tempat_turun": "madinah",
"arti": "Sapi",
"deskripsi": "Surat Al Baqarah yang 286 ayat itu turun di Madinah yang sebahagian besar diturunkan pada permulaan tahun Hijrah [...]",
"audio": "https://equran.nos.wjv-1.neo.id/audio-full/Misyari-Rasyid-Al-Afasi/002.mp3"
},
"surat_sebelumnya": false
}
Resources & Tools
Usage Notes
Rate Limiting
API ini memiliki rate limit yang wajar. Harap gunakan dengan bijak dan implementasikan caching di aplikasi Anda.
CORS
API mendukung Cross-Origin Resource Sharing (CORS) untuk penggunaan dari browser web.
Data Source
Data bersumber dari Aplikasi Quran Kementerian Agama RI dan audio dari berbagai qari terpercaya.
Butuh Bantuan?
Jika Anda memiliki pertanyaan atau membutuhkan bantuan teknis, jangan ragu untuk menghubungi kami.
Email: admin@equran.id