REGIONAL API
API Data Regional Wilayah Indonesia terlengkap — Provinsi, Kota, Kabupaten, Kecamatan, Kelurahan Kode pos
Akses provinsi, kota, kabupaten, kecamatan, kelurahan, dan kode pos di seluruh Indonesia dengan API Wilayah Indonesia gratis kami. JSON bersih, respons cepat, dan tanpa biaya komitmen—mulai gratis, upgrade saat diperlukan.
API Wilayah Indonesia: Data Regional Lengkap untuk Logistik, Checkout, dan Analitik
API Wilayah Indonesia (Indonesia Regional API) menyediakan data resmi yang selalu diperbarui untuk provinsi, kota/kabupaten, kecamatan, kelurahan, dan kode pos. Layanan ini ideal untuk autofill checkout e-commerce, cakupan logistik, validasi alamat, pemetaan, dan dashboard BI.
Dengan API ini, Anda mendapatkan JSON yang dapat diprediksi, respons cepat, dan pembaruan otomatis saat terjadi perubahan administratif. Tidak perlu lagi impor CSV atau pembaruan manual—aplikasi Anda tetap terkini untuk setiap wilayah Indonesia.
📊 Database Terlengkap di Indonesia
✨ Database Terlengkap di Indonesia
Hierarki Lengkap
Provinsi → kota → kecamatan → kelurahan dengan kode pos.
Cepat & Andal
Respons JSON latensi rendah, pengiriman berbasis CDN.
Gratis untuk Memulai
3.000 hits/bulan gratis, 0 poin per hit, upgrade kapan saja.
Pembaruan Otomatis
Tidak perlu sinkronisasi manual—data diperbarui saat wilayah berubah.
💰 Paket Sederhana
Mulai gratis, upgrade saat diperlukan
Pilih paket yang sesuai dengan kebutuhan Anda. Standard gratis untuk endpoint dasar, Premium untuk fitur lengkap termasuk search dan postal codes.
📋 Perbedaan Free vs Premium
Standard (Gratis):
- ✓ Provinces, Regencies, Districts, Villages
- ✓ Hierarki lengkap (province → regency → district → village)
- ✓ Filter by name pada setiap endpoint
- ✓ Pagination support
- ✗ Search API (premium only)
- ✗ Postal Codes API (premium only)
Premium:
- ✓ Semua fitur Standard
- ✓ Search API – cari across all types by name/postal code
- ✓ Postal Codes API – list semua kode pos & lookup by code
- ✓ Unlimited hits per bulan
- ✓ Rate limit lebih tinggi (100 req/s)
- ✓ Priority support
Dokumentasi API Wilayah Indonesia
Endpoint REST yang jelas untuk provinsi, kota, kabupaten, kecamatan, kelurahan, dan kode pos Indonesia. Pelajari cara menggunakan layanan ini dengan mudah. Dokumentasi lengkap mencakup semua endpoint yang tersedia.
🔐 Authentication: Semua request memerlukan header x-api-co-id dengan API key Anda. Dapatkan API key gratis di dashboard.
{{base-url}}/regional/indonesia/provinces
Daftar semua provinsi di Indonesia. Query parameters: name (optional) untuk filter by name, page (optional) untuk pagination.
{
"is_success": true,
"message": "Success",
"data": [
{
"code": "11",
"name": "ACEH"
},
{
"code": "12",
"name": "SUMATERA UTARA"
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 34,
"total_page": 1
}
}{{base-url}}/regional/indonesia/provinces/:code
Dapatkan provinsi tertentu berdasarkan kode (2 digits, contoh: 11 untuk Aceh).
{
"is_success": true,
"message": "Success",
"data": {
"code": "11",
"name": "ACEH"
}
}{{base-url}}/regional/indonesia/provinces/:code/regencies
Dapatkan semua kabupaten/kota dalam provinsi tertentu. Query parameters: name (optional), page (optional).
{
"is_success": true,
"message": "Success",
"data": [
{
"code": "1101",
"name": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH"
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 23,
"total_page": 1
}
}{{base-url}}/regional/indonesia/regencies
Daftar semua kabupaten/kota di Indonesia. Query parameters: province_code (optional), name (optional), page (optional).
{
"is_success": true,
"message": "Success",
"data": [
{
"code": "1101",
"name": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH"
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 514,
"total_page": 6
}
}{{base-url}}/regional/indonesia/regencies/:code
Dapatkan kabupaten/kota tertentu berdasarkan kode (4 digits, contoh: 1101).
{
"is_success": true,
"message": "Success",
"data": {
"code": "1101",
"name": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH"
}
}{{base-url}}/regional/indonesia/regencies/:code/districts
Dapatkan semua kecamatan dalam kabupaten/kota tertentu. Query parameters: name (optional), page (optional).
{
"is_success": true,
"message": "Success",
"data": [
{
"code": "110101",
"name": "TEUPAH SELATAN",
"regency_code": "1101",
"regency": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH"
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 10,
"total_page": 1
}
}{{base-url}}/regional/indonesia/districts
Daftar semua kecamatan di Indonesia. Query parameters: regency_code (optional), name (optional), page (optional).
{
"is_success": true,
"message": "Success",
"data": [
{
"code": "110101",
"name": "TEUPAH SELATAN",
"regency_code": "1101",
"regency": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH"
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 7277,
"total_page": 73
}
}{{base-url}}/regional/indonesia/districts/:code
Dapatkan kecamatan tertentu berdasarkan kode (6 digits, contoh: 110101).
{
"is_success": true,
"message": "Success",
"data": {
"code": "110101",
"name": "TEUPAH SELATAN",
"regency_code": "1101",
"regency": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH"
}
}{{base-url}}/regional/indonesia/districts/:code/villages
Dapatkan semua kelurahan dalam kecamatan tertentu. Query parameters: name (optional), page (optional).
{
"is_success": true,
"message": "Success",
"data": [
{
"code": "1101010001",
"name": "LATIUNG",
"district_code": "110101",
"district": "TEUPAH SELATAN",
"regency_code": "1101",
"regency": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH",
"postal_codes": ["23891"]
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 18,
"total_page": 1
}
}{{base-url}}/regional/indonesia/villages
Daftar semua kelurahan di Indonesia. Query parameters: district_code (optional), name (optional), postal_code (optional), page (optional).
{
"is_success": true,
"message": "Success",
"data": [
{
"code": "1101010001",
"name": "LATIUNG",
"district_code": "110101",
"district": "TEUPAH SELATAN",
"regency_code": "1101",
"regency": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH",
"postal_codes": ["23891"]
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 89525,
"total_page": 896
}
}{{base-url}}/regional/indonesia/villages/:code
Dapatkan kelurahan tertentu berdasarkan kode (10 digits, contoh: 1101010001) dengan informasi hierarki lengkap.
{
"is_success": true,
"message": "Success",
"data": {
"code": "1101010001",
"name": "LATIUNG",
"district_code": "110101",
"district": "TEUPAH SELATAN",
"regency_code": "1101",
"regency": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH",
"postal_codes": ["23891"]
}
}{{base-url}}/regional/indonesia/postal-codes
PREMIUM
Premium endpoint: Daftar semua kode pos di Indonesia. Query parameters: village_code (optional), postal_code (optional), page (optional). Memerlukan premium subscription.
{
"is_success": true,
"message": "Success",
"data": [
{
"id": 1,
"postal_code": "23891",
"village_code": "1101010001",
"village": "LATIUNG",
"district_code": "110101",
"district": "TEUPAH SELATAN",
"regency_code": "1101",
"regency": "KABUPATEN SIMEULUE",
"province_code": "11",
"province": "ACEH"
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 81574,
"total_page": 816
}
}{{base-url}}/regional/indonesia/postal-codes/:postal_code
PREMIUM
Premium endpoint: Cari kelurahan berdasarkan kode pos (5 digits, contoh: 12210). Memerlukan premium subscription.
{
"is_success": true,
"message": "Success",
"data": [
{
"code": "3174050001",
"name": "GROGOL UTARA",
"district_code": "317405",
"district": "KEBAYORAN LAMA",
"regency_code": "3174",
"regency": "KOTA JAKARTA SELATAN",
"province_code": "31",
"province": "DKI JAKARTA",
"postal_codes": ["12210"]
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 1,
"total_page": 1
}
}{{base-url}}/regional/indonesia/search?query=jakarta
PREMIUM
Premium endpoint: Pencarian advanced across semua tipe data regional (province, regency, district, village) by name atau postal code. Query parameters: query (required), type (optional: province, regency, district, village), page (optional). Memerlukan premium subscription.
{
"status": "success",
"timestamp": "2025-12-25 08:55:38",
"result": [
{
"province_code": "31",
"province": "DKI JAKARTA",
"city_code": "3174",
"city": "KOTA JAKARTA SELATAN",
"district_code": "317405",
"district": "KEBAYORAN LAMA",
"village_code": "3174050001",
"village": "GROGOL UTARA",
"postal_code": "12210"
}
],
"paging": {
"page": 1,
"size": 100,
"total_item": 1,
"total_page": 1
}
}Lihat Dokumentasi Lengkap
Lihat skema lengkap, header, batasan, dan explorer interaktif di dokumentasi resmi kami.
Pertanyaan Umum tentang API Wilayah Indonesia
Temukan jawaban untuk pertanyaan umum seputar API wilayah Indonesia, penggunaan, dan integrasi.
Apa itu API Wilayah Indonesia?
API Wilayah Indonesia adalah layanan API yang menyediakan database terlengkap tentang struktur administratif Indonesia, termasuk 38 provinsi, 514 kota/kabupaten, 7.277 kecamatan, 89.525 kelurahan, dan 81.574 kode pos. Layanan ini dirancang untuk memudahkan pengembang mengintegrasikan data regional Indonesia ke dalam aplikasi mereka tanpa perlu mengelola database sendiri. Endpoint dasar tersedia gratis, sementara fitur premium seperti search dan postal codes memerlukan subscription.
Bagaimana cara menggunakan API Wilayah Indonesia?
Untuk menggunakan layanan ini, Anda perlu mendaftar dan mendapatkan API key terlebih dahulu di dashboard. Setelah mendapatkan API key, sertakan dalam header request sebagai x-api-co-id: YOUR_API_KEY. Anda dapat mengakses berbagai endpoint seperti /regional/indonesia/provinces untuk mendapatkan daftar provinsi, atau /regional/indonesia/regencies untuk mendapatkan daftar kabupaten/kota. Semua endpoint mengembalikan data dalam format JSON dengan pagination support.
Apa perbedaan antara paket Standard (Gratis) dan Premium?
Standard (Gratis): Menyediakan akses ke endpoint dasar (provinces, regencies, districts, villages) dengan 3.000 hits per bulan, rate limit 20 req/s, dan 0 points per hit. Premium: Menawarkan semua fitur Standard plus akses ke Search API (pencarian advanced across all types) dan Postal Codes API (list dan lookup by postal code), unlimited hits per bulan, rate limit 100 req/s, dengan harga Rp 50.000/bulan. Premium juga termasuk priority support.
Apakah endpoint dasar benar-benar gratis?
Ya, endpoint dasar (provinces, regencies, districts, villages) benar-benar gratis dengan 0 points per hit. Paket Standard memberikan 3.000 successful hits per bulan dan 20 request per detik tanpa biaya. Cocok untuk pengembangan, testing, dan aplikasi dengan volume rendah. Jika Anda membutuhkan lebih banyak hits atau akses ke fitur premium (search dan postal codes), tersedia paket Premium dengan hits tak terbatas.
Bagaimana cara mengakses endpoint premium (Search dan Postal Codes)?
Endpoint premium seperti /regional/indonesia/search dan /regional/indonesia/postal-codes memerlukan premium subscription. Anda dapat upgrade kapan saja langsung dari dashboard dengan harga Rp 50.000 per bulan. Setelah upgrade, Anda akan mendapatkan akses ke Search API (pencarian by name atau postal code across all types) dan Postal Codes API (list semua kode pos dan lookup by code). Jika user non-premium mengakses endpoint premium, akan menerima response 403 Forbidden dengan pesan “This endpoint is for premium members only”.
Apa saja query parameters yang tersedia?
Setiap endpoint mendukung berbagai query parameters untuk filtering dan pagination: name (filter by name, case-insensitive partial match), page (pagination, default: 1), province_code (filter regencies by province), regency_code (filter districts by regency), district_code (filter villages by district), postal_code (filter villages by postal code). Pagination size fixed di 100 items per page dan tidak dapat dikonfigurasi. Untuk Search API, parameter query (required) dan type (optional: province, regency, district, village).
Seberapa lengkap data yang tersedia?
Database kami adalah yang terlengkap di Indonesia dengan 38 provinsi, 514 kota/kabupaten, 7.277 kecamatan, 89.525 kelurahan, dan 81.574 kode pos. Data mencakup seluruh hierarki administratif: provinsi → kabupaten/kota → kecamatan → kelurahan, beserta kode pos untuk setiap wilayah. Data diperbarui secara otomatis ketika terjadi perubahan administratif di Indonesia, sehingga aplikasi Anda selalu terkini tanpa pembaruan manual.
Apa saja yang bisa saya lakukan dengan layanan ini?
Layanan ini dapat digunakan untuk berbagai keperluan: E-commerce: autofill form checkout dan validasi alamat pengiriman. Logistik: pemetaan cakupan dan routing. CRM & Analytics: integrasi dengan sistem CRM dan dashboard analitik bisnis. Validasi: validasi alamat dan kode pos. Search: dengan premium, Anda dapat melakukan pencarian advanced across all types by name atau postal code. API ini mendukung hierarki lengkap dari provinsi hingga kelurahan beserta kode pos.
Bagaimana format response API?
Semua endpoint mengembalikan response dalam format JSON dengan struktur konsisten: is_success (boolean), message (string), data (array atau object), dan paging (object dengan page, size, total_item, total_page) untuk endpoint yang mendukung pagination. Response selalu dalam format yang dapat diprediksi dan mudah diintegrasikan. Untuk Search API, format sedikit berbeda dengan field status, timestamp, dan result.
Berapa lama waktu respons layanan ini?
Layanan ini dirancang dengan performa tinggi dan menggunakan CDN untuk pengiriman yang cepat. Waktu respons biasanya di bawah 200ms untuk sebagian besar request. Dengan infrastruktur yang andal, API ini dapat menangani 20 request per detik untuk paket Standard dan 100 request per detik untuk paket Premium. Rate limiting diterapkan untuk menjaga kualitas layanan untuk semua pengguna.
Bagaimana cara upgrade dari paket Standard ke Premium?
Anda dapat upgrade kapan saja langsung dari dashboard. Paket Premium menawarkan hits tak terbatas, rate limit lebih tinggi (100 req/s), akses ke Search API dan Postal Codes API, dengan harga tetap Rp 50.000 per bulan (sekitar $3,50). Proses upgrade sangat mudah dan tidak memerlukan perubahan kode—hanya perlu mengaktifkan paket Premium di dashboard. Setelah upgrade, semua endpoint premium akan langsung dapat diakses.
Apakah ada limit untuk pagination?
Ya, pagination size fixed di 100 items per page dan tidak dapat dikonfigurasi. Setiap response yang mendukung pagination akan menyertakan object paging dengan informasi: page (current page), size (items per page, selalu 100), total_item (total items), dan total_page (total pages). Gunakan parameter page untuk navigasi ke halaman berikutnya.
Mulai Gunakan API Wilayah Indonesia Sekarang
Luncurkan pengalaman siap Indonesia lebih cepat dengan layanan ini. Mulai gratis dengan 0 poin per hit. Jaga data regional Indonesia tetap terkini tanpa pembaruan manual.