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.

Upgrade ke API v2.0

Dapatkan fitur lebih lengkap dengan audio per ayat dan response yang lebih terstruktur

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

Example

https://equran.id/api/surat

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

Example

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

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

Example

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

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

Postman Collection

Download koleksi endpoint untuk testing

Download v1.0

Status Monitor

Pantau status layanan API real-time

Lihat Status

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