📍 Updated · July 2025 Restructuring

Vietnamese
Address Data API

Normalized administrative data with Vietnamese-aware search. Ready for frontend, backend, and mobile applications.

34
Provinces
3,321
Wards
8
Endpoints
—
Uptime (s)
Offline Package

vietnam-address-data

NPM Package

Thư viện offline hoàn chỉnh giúp tra cứu, chuẩn hóa địa chỉ Việt Nam mà không cần kết nối API. Phù hợp cho ứng dụng yêu cầu độ trễ cực thấp (phản hồi <1ms) hoặc cần hoạt động khi mất kết nối mạng.

bash
npm i vietnam-address-data
⚡
Tốc độ < 1ms
Dữ liệu nạp vào RAM cho tốc độ truy vấn tối đa
📦
Siêu Nhẹ
~400KB JSON, không phụ thuộc package khác
🛡️
Bảo Mật
100% Offline, không truyền dữ liệu ra ngoài
🔷
TypeScript
Fully typed, hỗ trợ autocomplete khi viết code

            

          

        


        
        

          

            Câu hỏi thường gặp & Tài liệu tham khảo (FAQ)
          


          

            

              
              

                

                  Dữ liệu tỉnh thành, quận huyện, phường xã được đối chiếu và chuẩn hóa dựa trên các công bố chính thức từ Tổng cục Thống kê và Cổng thông tin điện tử Bộ Nội vụ Việt Nam, cập nhật hoàn chỉnh theo các nghị quyết sắp xếp địa giới hành chính mới nhất tính đến tháng 7/2025.
                

              

            


            

              
              

                

                  Bạn có thể tải ranh giới địa lý chi tiết của từng tỉnh thành bằng cách gọi endpoint GET /api/provinces/:id/boundary hoặc cài đặt gói thư viện offline vietnam-address-data trên NPM để sử dụng trực tiếp trong dự án NodeJS/Frontend.
                

              

            


            

              
              

                

                  Nhằm đảm bảo hiệu năng và tính ổn định cho cộng đồng nhà phát triển, API áp dụng giới hạn Rate Limit ở mức 100 requests / 15 phút. Nếu ứng dụng của bạn cần lưu lượng lớn hơn hoặc hoạt động ngoại tuyến, chúng tôi khuyến khích sử dụng thư viện offline NPM.