API Al-Quran: 114 Surah Lengkap dalam Format JSON untuk Developer

Membangun aplikasi Al-Quran, reminder ibadah, atau widget "surah pilihan" butuh data surah yang terstruktur dan konsisten. API Al-Quran dari API Indonesia menyediakan seluruh 114 surah lengkap dengan nama Arab, transliterasi Latin, terjemahan nama, jumlah ayat, tempat turun (Makkiyah/Madaniyah), urutan pewahyuan, dan tautan audio murottal — semuanya lewat REST API sederhana.

Daftar Endpoint

Base URL: https://use.apiindonesia.id/api/v1/quran

Method	Endpoint	Keterangan
GET	/list-surah	Daftar seluruh 114 surah, terurut sesuai mushaf
GET	/surah/:id	Detail satu surah berdasarkan nomor (1–114)

Contoh Request

curl "https://use.apiindonesia.id/api/v1/quran/list-surah" \
  -H "x-api-key: aip_live_xxx"

curl "https://use.apiindonesia.id/api/v1/quran/surah/36" \
  -H "x-api-key: aip_live_xxx"

async function getSurah(nomor) {
  const res = await fetch(`https://use.apiindonesia.id/api/v1/quran/surah/${nomor}`, {
    headers: { 'x-api-key': process.env.API_INDONESIA_KEY },
  });
  const { data } = await res.json();
  return data;
}

const yasin = await getSurah(36);
console.log(yasin.name_latin, '-', yasin.number_of_ayahs, 'ayat');

import requests

res = requests.get(
    "https://use.apiindonesia.id/api/v1/quran/list-surah",
    headers={"x-api-key": "aip_live_xxx"},
)
surah_list = res.json()["data"]
for s in surah_list[:5]:
    print(s["name_latin"], s["revelation_place"])

Contoh Response

{
  "data": {
    "id": 36,
    "name": "يس",
    "name_latin": "Yasin",
    "name_arabic": "يس",
    "name_translation": "Ya Sin",
    "number_of_ayahs": 83,
    "revelation_place": "Makkiyah",
    "revelation_order": 41,
    "audio_url": "https://.../036.mp3"
  }
}

Kasus Pakai

• Aplikasi Al-Quran digital — daftar navigasi 114 surah beserta jumlah ayat.
• Widget "surah hari ini" — pilih surah acak dari /list-surah dan putar audio dari audio_url.
• Aplikasi hafalan (tahfidz) — gunakan number_of_ayahs untuk menghitung progres hafalan per surah.
• Chatbot/asisten Islami — jawab pertanyaan seperti "surah apa yang turun di Makkah" memakai field revelation_place.

FAQ

Apakah tersedia teks ayat dan terjemahan per ayat? Endpoint saat ini fokus pada metadata surah (nama, jumlah ayat, tempat turun, audio); untuk kebutuhan teks per-ayat, hubungi tim kami melalui dokumentasi untuk roadmap terbaru.

Format audio apa yang dipakai di audio_url? Tautan mengarah ke file audio murottal per surah yang bisa langsung dipakai di elemen <audio> atau player aplikasi mobile.

Apakah nomor surah mengikuti urutan mushaf atau urutan turun? Endpoint /list-surah terurut sesuai urutan dalam mushaf (1–114), sementara revelation_order menunjukkan urutan pewahyuannya.

Mulai Sekarang

Dapatkan API key gratis di dashboard.apiindonesia.id/register dan lihat detail skema response di docs.apiindonesia.id.