🌏 Nusantara-API 🇮🇩 — from MySQL dump to a tiny 420 KB library

A while ago, I was looking for Indonesian regional data for one of my projects.


Most of the datasets I found came as large MySQL dumps, which required importing into a database just to access provinces or districts.

Then I found the file wilayah.sql from cahyadsn/wilayah.


It contains complete administrative data — provinces, cities, districts, and villages across Indonesia.

I tried to process it so developers could use it directly — no database setup, no SQL import.


After cleaning and compressing it with Brotli, the raw data size went from ~2.5 MB down to only ~420 KB.

The result is Nusantara-API 🚀


A small library for accessing Indonesian regional data — usable in Node.js, frontend, or directly via CDN.

🔗 Links

• 
  GitHub: github.com/ibnushahraa/nusantara-api
  


• 
  Source DB (MySQL dump): github.com/cahyadsn/wilayah
  


• 
  npm: npmjs.com/package/nusantara-api
  


• 
  Demo: ibnushahraa.github.io/nusantara-api
  

Sometimes small experiments end up becoming something useful for others.


This project started as a simple curiosity — and turned into a compact, shareable dataset for developers who just need quick access to Indonesian regions.

If you find it helpful or have ideas for improvement, feel free to open an issue or contribute on GitHub 🙌