Ước tính chi phí xây nhà API
Ước tính diện tích xây dựng quy đổi và chi phí xây nhà ở Việt Nam, hiện rõ và cho sửa từng hệ số móng, mái, hầm, sân.
Nhà thầu ở Việt Nam báo giá theo m² diện tích quy đổi: các sàn tính 100%, còn móng, hầm, mái, sân và ô trống nhân hệ số thường dùng (móng băng 50% diện tích tầng trệt, móng cọc 40%, mái BTCT 50%, mái ngói vì kèo 70%, hầm 150–250% theo độ sâu, sân 50%…). API lập bảng đó từ kích thước đất, số tầng, loại móng, mái và các diện tích phụ, rồi nhân với đơn giá.
Không có bảng hệ số chính thức nên mỗi hệ số là giá trị mặc định có nhãn, sửa được bằng coefficients, còn đơn giá là các mức gợi ý sửa được (phần thô, trọn gói phổ thông, khá, cao cấp) hoặc unit_price của bạn. Kết quả tách phần thô và phần hoàn thiện, kèm danh sách khoản chưa tính (ép cọc, phá dỡ, giấy phép, nội thất).
Dùng để lập ngân sách sơ bộ; báo giá thực tế phụ thuộc thiết kế, mặt bằng và vật tư.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
width, length | query|body | number | không | Kích thước sàn tầng trệt (m), hoặc gửi floor_area. | |
floor_area | query|body | number | không | Diện tích sàn tầng trệt (m²). | |
floors | query|body | number | không | 1 | Số tầng, kể cả tầng trệt. |
foundation | query|body | string | không | strip | single (móng đơn), strip (móng băng), pile (móng cọc), raft (móng bè). |
roof | query|body | string | không | concrete | metal (tôn), concrete (BTCT), tile_steel (ngói vì kèo thép), tile_concrete (ngói đổ BTCT), none. |
basement_depth, mezzanine_area, stair_tower_area, terrace_area, balcony_area, yard_area, void_area, upper_floor_area, roof_area | query|body | number | không | Các phần tùy chọn (m², độ sâu hầm tính bằng m). | |
package | query|body | string | không | standard | Mức giá: rough (thô), basic, standard, premium. |
unit_price | query|body | number | không | Đơn giá của bạn cho mỗi m² quy đổi (thay mức gợi ý). | |
coefficients | body|query | object | không | Sửa hệ số, ví dụ {"foundation.pile": 0.5, "roof.metal": 0.25, "yard": 0.7}. |
Ví dụ
curl "https://apibox.io.vn/v1/vn-build-cost?width=5&length=20&floors=3&foundation=strip&roof=concrete&package=standard" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-build-cost?width=5&length=20&floors=3&foundation=strip&roof=concrete&package=standard', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-build-cost?width=5&length=20&floors=3&foundation=strip&roof=concrete&package=standard",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-build-cost?width=5&length=20&floors=3&foundation=strip&roof=concrete&package=standard');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"footprint_m2": 100,
"floors": 3,
"rows": [
{
"part": "Foundation",
"part_vi": "Móng",
"area_m2": 100,
"coefficient": 0.5,
"converted_m2": 50,
"basis": "Strip foundation (móng băng) 50%"
},
{
"part": "Ground floor",
"part_vi": "Tầng trệt",
"area_m2": 100,
"coefficient": 1,
"converted_m2": 100,
"basis": "Each floor, mezzanine, stair tower, balcony 100%"
},
{
"part": "Floor 2",
"part_vi": "Tầng 2",
"area_m2": 100,
"coefficient": 1,
"converted_m2": 100,
"basis": "Each floor, mezzanine, stair tower, balcony 100%"
},
{
"part": "Floor 3",
"part_vi": "Tầng 3",
"area_m2": 100,
"coefficient": 1,
"converted_m2": 100,
"basis": "Each floor, mezzanine, stair tower, balcony 100%"
},
{
"part": "Roof (concrete)",
"part_vi": "Mái (concrete)",
"area_m2": 100,
"coefficient": 0.5,
"converted_m2": 50,
"basis": "Flat concrete roof (mái BTCT) 50%"
}
],
"converted_area_m2": 400,
"cost": {
"package": "standard",
"package_vi": "Trọn gói khá",
"unit_price": 6500000,
"unit_price_source": "preset (editable default, not an official price)",
"total": 2600000000,
"rough_part": 1520000000,
"finishing_part": 1080000000
},
"excluded": [
"piling (ép cọc / khoan nhồi), billed per metre",
"demolition and soil disposal",
"permit, design and supervision fees",
"furniture, air conditioners, appliances",
"difficult access or night work surcharges"
],
"reviewed": "2026-11-11"
}
Ứng dụng
- Cho khách tự ước tính trên website nhà thầu
- Ước tính khoản vay xây nhà trong app ngân hàng
- So sánh báo giá của nhiều nhà thầu trên cùng cách tính
- Lên kế hoạch xây nhà trước khi thuê kiến trúc sư
Hỏi đáp
Hệ số có phải quy định chính thức không?
Không. Đây là thông lệ của nhà thầu, mỗi nơi một khác; mọi hệ số đều hiện ra và sửa được.
Đơn giá có cập nhật không?
Là mức gợi ý theo báo giá ở thành phố lớn năm 2026; gửi unit_price theo báo giá nhà thầu của bạn.
Đã gồm ép cọc chưa?
Chưa. Ép cọc tính theo mét dài cọc; hệ số móng chỉ gồm đài cọc, giằng móng.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.