API Wilayah Indonesia 2026: Perbandingan emsifa, wilayah.id, BPS, dan API Indonesia

Kalau Anda mencari "API wilayah Indonesia", ada empat pilihan yang paling sering muncul: emsifa/api-wilayah-indonesia, wilayah.id, Web API BPS, dan API Indonesia. Keempatnya bisa dipakai untuk dropdown alamat provinsi sampai kelurahan, tapi cara kerja, kelengkapan, dan risikonya beda. Artikel ini membandingkan keempatnya apa adanya, berdasarkan pengecekan langsung ke masing-masing endpoint pada 24 Oktober 2026.

Ringkasan cepat

	emsifa (v2)	wilayah.id	Web API BPS	API Indonesia
Jenis	JSON statis (GitHub Pages)	JSON statis	API resmi BPS	REST API dengan API key
Biaya	Gratis	Gratis	Gratis, wajib daftar	Bonus 3.000 kredit, lalu 2 kredit (Rp2) per request sukses
Jumlah provinsi	38 (di /v2/), endpoint lama /api/ masih 34	38	Mengikuti kode BPS	38
Rujukan data	Kemendagri	Kepmendagri No 300.2.2-2138 Tahun 2025	Kode wilayah BPS	Kepmendagri 2025 (transkripsi cahyadsn/wilayah)
Kode pos kelurahan	Ada	Tidak ada	Tidak	Ada
Koordinat	Semua level	Tidak ada	Tidak	Provinsi (kelurahan belum)
Pencarian nama wilayah	Tidak	Tidak	Tidak untuk dropdown alamat	Ada (/wilayah/search)
Data lain dalam satu key	Tidak	Tidak	Statistik BPS	30 produk API (hari libur, kode pos, BMKG, kurs BI, dan lainnya)

Intinya: kalau Anda butuh data gratis untuk dropdown statis dan tidak keberatan menyimpan atau mengikuti satu repo komunitas, emsifa v2 dan wilayah.id sudah cukup bagus. Kalau Anda butuh pencarian nama wilayah, kode pos per kelurahan dari satu endpoint, dan data publik lain dengan satu API key, API Indonesia lebih praktis.

1. emsifa/api-wilayah-indonesia

Proyek open source paling populer untuk data wilayah. Datanya disajikan sebagai file JSON statis lewat GitHub Pages, jadi tidak ada API key dan tidak ada rate limit dari server aplikasi.

Yang perlu diperhatikan: ada dua versi endpoint. Endpoint lama di /api-wilayah-indonesia/api/provinces.json masih mengembalikan 34 provinsi, tanpa empat provinsi baru di Papua (Papua Selatan, Papua Tengah, Papua Pegunungan, Papua Barat Daya). Versi baru di /api-wilayah-indonesia/v2/ sudah 38 provinsi dan jauh lebih lengkap: ada koordinat, populasi, luas wilayah, dan kode pos di level kelurahan.

Kalau aplikasi Anda masih memakai URL lama, cek lagi. Banyak tutorial lama di internet masih menulis endpoint /api/.

Cocok untuk: dropdown alamat di frontend, prototipe, proyek tanpa anggaran. Keterbatasan: tidak ada pencarian teks bebas, hanya navigasi berdasarkan ID induk. Tidak ada jaminan uptime karena dikelola komunitas.

2. wilayah.id

API statis yang mengikuti Kepmendagri No 300.2.2-2138 Tahun 2025, dengan pembaruan terakhir tercatat 4 Juli 2025. Endpointnya sederhana: provinces.json, regencies/{kode}.json, districts/{kode}.json, dan villages/{kode}.json, dengan kode bertitik seperti 31.71.06.

Cocok untuk: kebutuhan kode wilayah Kemendagri terbaru tanpa biaya. Keterbatasan: hanya kode dan nama. Tidak ada kode pos, koordinat, atau pencarian.

3. Web API BPS

Sumber resmi dari Badan Pusat Statistik. Wajib registrasi untuk mendapat key. Hal yang sering bikin bingung: kode wilayah BPS tidak selalu sama dengan kode Kemendagri. Kalau sistem Anda menyimpan alamat pengguna dengan kode Kemendagri (yang dipakai di KTP dan administrasi pemerintahan), jangan campur dengan kode BPS tanpa tabel pemetaan.

Cocok untuk: analisis statistik dan riset yang memang memakai kode BPS. Keterbatasan: bukan dibuat untuk dropdown alamat aplikasi.

4. API Indonesia

REST API berbayar per pemakaian dengan bonus 3.000 kredit saat daftar (cukup untuk sekitar 1.500 request). Data wilayah mengikuti Kepmendagri 2025 dengan total 91.599 baris dari provinsi sampai kelurahan/desa, 38 provinsi, dan 514 kabupaten/kota.

Yang membedakan dari opsi gratis di atas:

• Pencarian nama wilayah lintas level. Pengguna mengetik "menteng" dan Anda langsung dapat kecamatan dan kelurahan yang cocok.
• Kode pos ikut di data kelurahan, plus API Kode Pos terpisah untuk pencarian kode pos.
• Satu API key untuk 30 produk API, misalnya hari libur nasional, jadwal sholat, cuaca dan gempa BMKG, kurs Bank Indonesia, dan validasi NIK/NPWP.
• Respons JSON seragam, halaman status di status.apiindonesia.id, plus integrasi n8n dan MCP server untuk AI agent.

Keterbatasan yang perlu Anda tahu: koordinat baru tersedia di level provinsi, belum di kabupaten sampai kelurahan. Kalau Anda butuh titik koordinat per kelurahan, emsifa v2 saat ini lebih lengkap untuk kebutuhan itu.

Contoh: cari wilayah dari nama

curl "https://use.apiindonesia.id/api/v1/wilayah/search?q=menteng" \
  -H "x-api-key: YOUR_API_KEY"

Respons (dipotong):

{
  "success": true,
  "data": [
    { "id": "317106", "name": "Menteng", "alt_name": null, "level": "kecamatan" },
    { "id": "3171061001", "name": "Menteng", "alt_name": null, "level": "kelurahan" },
    { "id": "3174011003", "name": "Menteng Dalam", "alt_name": null, "level": "kelurahan" }
  ]
}

Contoh: kelurahan beserta kode pos

curl "https://use.apiindonesia.id/api/v1/wilayah/kecamatan/317106/kelurahan" \
  -H "x-api-key: YOUR_API_KEY"

{
  "success": true,
  "data": [
    { "id": "3171061001", "district_id": "317106", "name": "Menteng", "postal_code": "10310", "type": "kelurahan" },
    { "id": "3171061002", "district_id": "317106", "name": "Pegangsaan", "postal_code": "10320", "type": "kelurahan" },
    { "id": "3171061003", "district_id": "317106", "name": "Cikini", "postal_code": "10330", "type": "kelurahan" }
  ]
}

Daftar endpoint lengkap ada di dokumentasi API Wilayah dan halaman produk API Wilayah.

Mana yang sebaiknya dipilih?

• Prototipe atau dropdown sederhana, tanpa anggaran: emsifa v2 (pastikan pakai /v2/) atau wilayah.id.
• Aplikasi produksi yang butuh pencarian alamat, kode pos, dan data publik lain: API Indonesia.
• Riset statistik: Web API BPS.
• Sistem yang tidak boleh bergantung pada pihak ketiga saat runtime: unduh datasetnya (emsifa, cahyadsn/wilayah, atau ekspor dari API), simpan di database sendiri, dan jadwalkan pembaruan saat ada Kepmendagri baru.

Apa pun pilihannya, simpan kode wilayah, bukan hanya nama. Nama kelurahan banyak yang sama di provinsi berbeda (ada puluhan "Menteng" dan "Sukamaju"), sedangkan kode Kemendagri unik.

FAQ

Berapa jumlah provinsi di Indonesia saat ini? 38 provinsi, setelah pemekaran Papua Selatan, Papua Tengah, Papua Pegunungan (2022), dan Papua Barat Daya (2022). API yang masih mengembalikan 34 provinsi memakai data lama.

Apakah API wilayah emsifa masih bisa dipakai? Bisa. Gunakan endpoint /v2/ yang sudah 38 provinsi dan menyertakan kode pos serta koordinat. Endpoint lama /api/ masih 34 provinsi.

Apa beda kode wilayah Kemendagri dan BPS? Kemendagri adalah kode administrasi pemerintahan (dipakai di KTP dan dokumen resmi), sedangkan BPS adalah kode untuk statistik. Keduanya sering mirip tapi tidak selalu sama, jadi jangan dicampur tanpa pemetaan.

Apakah API Indonesia gratis untuk data wilayah? Ada bonus 3.000 kredit sekali saat daftar, setara sekitar 1.500 request. Setelah itu tiap request sukses memakai 2 kredit (Rp2), dan request gagal tidak dikenakan biaya. Paket Pro Rp49.000/bulan memberi 50.000 kredit.

Apakah ada pencarian nama kelurahan? Di API Indonesia ada, lewat GET /api/v1/wilayah/search?q=.... emsifa dan wilayah.id hanya menyediakan navigasi berdasarkan kode induk.

Lihat datanya langsung: daftar wilayah per provinsi dan kabupaten/kota lengkap dengan kode Kemendagri dan jumlah kecamatan/desa.