Latest Version
v2.0

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

01
Abdullah Al-Juhany
02
Abdul Muhsin Al-Qasim
03
Abdurrahman as-Sudais
04
Ibrahim Al-Dossari
05
Misyari Rasyid Al-Afasi

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

Example

https://equran.id/api/v2/surat

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

Example

https://equran.id/api/v2/surat/1

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

Example

https://equran.id/api/v2/tafsir/1

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

Postman Collection

Download koleksi endpoint v2.0 untuk testing

Download v2.0

Status Monitor

Pantau status layanan API real-time

Lihat Status

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.

Masih menggunakan API v1.0?

Akses dokumentasi versi lama untuk referensi

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