API Developer v2.0
API terbaru dengan fitur lengkap untuk mengakses data Al-Quran, audio berkualitas tinggi dari 5 qari terbaik, dan format response yang lebih terstruktur sesuai best practice REST API.
Statistik API (30 Hari Terakhir)
1M++
Total Requests
50GB++
Data Transfer
50++
Country Origins
🚀 API yang dipercaya oleh developer di seluruh dunia untuk mengintegrasikan Al-Quran dalam aplikasi mereka
Fitur Terbaru v2.0
- Audio per ayat dari 5 qari terbaik
- Response format yang konsisten
- Performa lebih cepat dan stabil
- Best practice REST API
- Error handling yang lebih baik
- Dokumentasi yang lebih lengkap
Data Lengkap
114 surat, 6236 ayat dengan terjemahan dan tafsir
Audio Premium
Audio per ayat dari 5 qari terbaik dunia
Performa Tinggi
Response cepat dengan CDN global
REST API
Format JSON standar dan konsisten
Base URL
https://equran.id/api/v2
Available Qari
Available Endpoints
GET/api/v2/surat
Mendapatkan daftar semua surat dalam Al-Quran dengan audio lengkap
Response
Array dari objek surat dengan informasi lengkap dan audio dari 5 qari
Contoh Response
{
"code": 200,
"message": "Data retrieved successfully",
"data": [
{
"nomor": 1,
"nama": "الفاتحة",
"namaLatin": "Al-Fatihah",
"jumlahAyat": 7,
"tempatTurun": "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. [...]",
"audioFull": {
"01": "https://equran.nos.wjv-1.neo.id/audio-full/Abdullah-Al-Juhany/001.mp3",
"02": "https://equran.nos.wjv-1.neo.id/audio-full/Abdul-Muhsin-Al-Qasim/001.mp3",
"03": "https://equran.nos.wjv-1.neo.id/audio-full/Abdurrahman-as-Sudais/001.mp3",
"04": "https://equran.nos.wjv-1.neo.id/audio-full/Ibrahim-Al-Dossari/001.mp3",
"05": "https://equran.nos.wjv-1.neo.id/audio-full/Misyari-Rasyid-Al-Afasi/001.mp3"
}
}
]
}
GET/api/v2/surat/{id}
Mendapatkan detail surat beserta ayat-ayatnya dengan audio per ayat
Response
Objek surat lengkap dengan array ayat dan audio individual
Contoh Response
{
"code": 200,
"message": "Data retrieved successfully",
"data": {
"nomor": 1,
"nama": "الفاتحة",
"namaLatin": "Al-Fatihah",
"jumlahAyat": 7,
"tempatTurun": "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. [...]",
"audioFull": {
"01": "https://equran.nos.wjv-1.neo.id/audio-full/Abdullah-Al-Juhany/001.mp3",
"02": "https://equran.nos.wjv-1.neo.id/audio-full/Abdul-Muhsin-Al-Qasim/001.mp3",
"03": "https://equran.nos.wjv-1.neo.id/audio-full/Abdurrahman-as-Sudais/001.mp3",
"04": "https://equran.nos.wjv-1.neo.id/audio-full/Ibrahim-Al-Dossari/001.mp3",
"05": "https://equran.nos.wjv-1.neo.id/audio-full/Misyari-Rasyid-Al-Afasi/001.mp3"
},
"ayat": [
{
"nomorAyat": 1,
"teksArab": "بِسْمِ اللّٰهِ الرَّحْمٰنِ الرَّحِيْمِ",
"teksLatin": "bismillāhir-raḥmānir-raḥīm(i).",
"teksIndonesia": "Dengan nama Allah Yang Maha Pengasih, Maha Penyayang.",
"audio": {
"01": "https://equran.nos.wjv-1.neo.id/audio-partial/Abdullah-Al-Juhany/001001.mp3",
"02": "https://equran.nos.wjv-1.neo.id/audio-partial/Abdul-Muhsin-Al-Qasim/001001.mp3",
"03": "https://equran.nos.wjv-1.neo.id/audio-partial/Abdurrahman-as-Sudais/001001.mp3",
"04": "https://equran.nos.wjv-1.neo.id/audio-partial/Ibrahim-Al-Dossari/001001.mp3",
"05": "https://equran.nos.wjv-1.neo.id/audio-partial/Misyari-Rasyid-Al-Afasi/001001.mp3"
}
}
],
"suratSelanjutnya": {
"nomor": 2,
"nama": "البقرة",
"namaLatin": "Al-Baqarah",
"jumlahAyat": 286
},
"suratSebelumnya": false
}
}
GET/api/v2/tafsir/{id}
Mendapatkan tafsir untuk surat tertentu dengan format yang lebih baik
Response
Objek surat dengan array tafsir per ayat yang terstruktur
Contoh Response
{
"code": 200,
"message": "Data retrieved successfully",
"data": {
"nomor": 1,
"nama": "الفاتحة",
"namaLatin": "Al-Fatihah",
"jumlahAyat": 7,
"tempatTurun": "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. [...]",
"audioFull": {
"01": "https://equran.nos.wjv-1.neo.id/audio-full/Abdullah-Al-Juhany/001.mp3",
"02": "https://equran.nos.wjv-1.neo.id/audio-full/Abdul-Muhsin-Al-Qasim/001.mp3",
"03": "https://equran.nos.wjv-1.neo.id/audio-full/Abdurrahman-as-Sudais/001.mp3",
"04": "https://equran.nos.wjv-1.neo.id/audio-full/Ibrahim-Al-Dossari/001.mp3",
"05": "https://equran.nos.wjv-1.neo.id/audio-full/Misyari-Rasyid-Al-Afasi/001.mp3"
},
"tafsir": [
{
"ayat": 1,
"teks": "Surah al-Fatihah dimulai dengan Basmalah
Ada beberapa pendapat ulama berkenaan dengan Basmalah yang terdapat pada permulaan surah Al-Fatihah. [...]"
}
],
"suratSelanjutnya": {
"nomor": 2,
"nama": "البقرة",
"namaLatin": "Al-Baqarah",
"jumlahAyat": 286
},
"suratSebelumnya": false
}
}
Resources & Tools
Migration dari v1.0
v1.0 (Deprecated)
GET /api/surat
GET /api/surat/1
GET /api/tafsir/1
v2.0 (Recommended)
GET /api/v2/surat
GET /api/v2/surat/1
GET /api/v2/tafsir/1
Catatan: API v1.0 masih dapat digunakan, namun kami sangat merekomendasikan untuk migrasi ke v2.0 untuk mendapatkan fitur terbaru dan performa yang lebih baik.
Usage Notes
Rate Limiting
API v2.0 memiliki rate limit yang lebih generous. Implementasikan caching untuk performa optimal dan penggunaan bandwidth yang efisien.
Audio Files
Setiap ayat menyediakan 5 pilihan audio dari qari terbaik. Gunakan audio dengan bijak untuk menghemat bandwidth pengguna.
Error Handling
API v2.0 menggunakan HTTP status codes standar dan response format yang konsisten untuk error handling yang lebih baik.
CORS Support
Full CORS support untuk penggunaan dari browser web dengan konfigurasi yang lebih fleksibel.
Butuh Bantuan?
Tim developer kami siap membantu Anda mengintegrasikan API v2.0 ke dalam aplikasi Anda.
Email: equran.id@gmail.com