Tài liệu · Khung giá đất
GET /api/v1/giadat
Trả về khung giá đất do nhà nước ban hành cho một đơn vị hành chính, tra được tới cấp tên đường. Dữ liệu đồng bộ lại mỗi khi tỉnh công bố quyết định mới.
Cần API Key
Cache 24 giờ
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
province
string
Có
Slug tỉnh hoặc thành phố, ví dụ ha-noi, lam-dong.
district
string
Không
Slug quận hoặc huyện. Bỏ trống sẽ trả toàn tỉnh.
street
string
Không
Lọc theo tên đường, không phân biệt dấu.
limit
integer
Không
Số bản ghi mỗi trang, tối đa 500. Mặc định 100.
Response mẫu
{
"status": "success",
"province": "Lâm Đồng",
"district": "TP. Đà Lạt",
"unit": "VND/m2",
"count": 412,
"items": [
{ "ward": "Phường 1", "street": "Nguyễn Thị Minh Khai", "position": 1, "price": 62400000 },
{ "ward": "Phường 1", "street": "Trần Phú", "position": 1, "price": 58100000 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Giá vàng
GET /api/v1/gold-prices
Giá mua vào và bán ra của các thương hiệu vàng trong nước, kèm mốc thời gian cập nhật gần nhất.
Cần API Key
Cache 15 phút
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
brand
string
Không
sjc, doji, pnj, btmc, mihong, phuquy hoặc all.
type
string
Không
mieng hoặc nhan. Mặc định trả cả hai.
Response mẫu
{
"status": "success",
"unit": "VND/luong",
"brands": [
{ "name": "SJC", "buy": 88500000, "sell": 90500000 },
{ "name": "Doji", "buy": 88350000, "sell": 90400000 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Giá bạc
GET /api/v1/silver-prices
Giá bạc miếng và bạc thỏi của các thương hiệu trong nước, kèm giá bạc thế giới XAG/USD.
Cần API Key
Cache 15 phút
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
brand
string
Không
phu-quy, doji, ancarat hoặc all.
Response mẫu
{
"status": "success",
"brands": [
{ "name": "Phú Quý", "buy": 1268000, "sell": 1320000 }
],
"world": { "code": "XAG/USD", "price": 32.18 }
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Tỷ giá ngoại tệ
GET /api/v1/exchange-rates
Tỷ giá tiền mặt, chuyển khoản và bán ra theo niêm yết ngân hàng, mặc định Vietcombank.
Cần API Key
Cache 30 phút
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
bank
string
Không
Slug ngân hàng. Mặc định vietcombank.
currency
string
Không
Mã tiền tệ ISO, ví dụ USD, EUR.
Response mẫu
{
"status": "success",
"bank": "Vietcombank",
"rates": [
{ "code": "USD", "cash": 25120, "transfer": 25150, "sell": 25480 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Mã SWIFT ngân hàng
GET /api/v1/swift-codes
Tra cứu SWIFT/BIC code của hơn 600 ngân hàng và chi nhánh tại Việt Nam theo tên hoặc mã.
Cần API Key
Cache 7 ngày
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
q
string
Không
Từ khoá tên ngân hàng hoặc mã SWIFT.
city
string
Không
Lọc theo thành phố đặt chi nhánh.
Response mẫu
{
"status": "success",
"items": [
{ "bank": "Vietcombank", "swift": "BFTVVNVX", "city": "Hà Nội" },
{ "bank": "BIDV", "swift": "BIDVVNVX", "city": "Hà Nội" }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Danh sách bệnh viện
GET /api/v1/hospitals
Danh sách bệnh viện và phòng khám trên toàn quốc kèm địa chỉ, tuyến, chuyên khoa và hình ảnh.
Cần API Key
Cache 24 giờ
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
province
string
Không
Slug tỉnh hoặc thành phố.
level
string
Không
trung-uong, tinh, huyen hoặc phong-kham.
Response mẫu
{
"status": "success",
"count": 1218,
"items": [
{ "name": "Bệnh viện Bạch Mai", "level": "trung-uong", "province": "Hà Nội" }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Lãi suất tiết kiệm
GET /api/v1/laisuat
Bảng lãi suất tiền gửi theo kỳ hạn của hơn 30 ngân hàng, dùng để so sánh hoặc dựng bảng xếp hạng.
Cần API Key
Cache 12 giờ
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
bank
string
Không
Slug ngân hàng cụ thể.
term
integer
Không
Kỳ hạn tính theo tháng, 1 đến 36.
Response mẫu
{
"status": "success",
"items": [
{ "bank": "Vietcombank", "term_6": 3.2, "term_12": 4.7, "term_24": 4.8 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Lãi suất vay
GET /api/v1/laisuatvay
Gói vay ưu đãi sản xuất, tiêu dùng và bất động sản kèm lãi suất ưu đãi, thời gian cố định và điều kiện.
Cần API Key
Cache 12 giờ
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
type
string
Không
mua-nha, tieu-dung hoặc san-xuat.
bank
string
Không
Slug ngân hàng cụ thể.
Response mẫu
{
"status": "success",
"items": [
{ "bank": "VPBank", "type": "mua-nha", "promo_rate": 6.5, "promo_months": 24 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Chỉ số vĩ mô World Bank
GET /api/v1/worldbank/indicators
Chỉ số vĩ mô Việt Nam theo năm lấy từ World Bank: GDP, dân số, CPI, FDI và nhiều chỉ số khác.
Cần API Key
Cache 7 ngày
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
indicator
string
Có
Mã chỉ số, ví dụ NY.GDP.MKTP.CD.
from
integer
Không
Năm bắt đầu. Mặc định 2000.
Response mẫu
{
"status": "success",
"indicator": "NY.GDP.MKTP.CD",
"series": [
{ "year": 2024, "value": 476300000000 },
{ "year": 2025, "value": 505100000000 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Trung tâm bóng đá
GET /api/v1/football
Bảng xếp hạng, lịch đấu và timeline 38 vòng của các giải lớn cùng dữ liệu đội tuyển quốc gia.
Cần API Key
Cache 5 phút
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
league
string
Có
Slug giải đấu, ví dụ premier-league.
round
integer
Không
Vòng đấu cụ thể.
Response mẫu
{
"status": "success",
"league": "premier-league",
"round": 12,
"matches": [
{ "home": "Arsenal", "away": "Chelsea", "score": "2-1", "status": "FT" }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · BXH FIFA
GET /api/v1/football/fifa-rankings
Thứ hạng, điểm số và biến động của 211 đội tuyển thành viên FIFA, kèm mã cờ để hiển thị.
Cần API Key
Cache 24 giờ
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
limit
integer
Không
Số đội trả về, tối đa 211.
confederation
string
Không
afc, uefa, conmebol, caf, concacaf, ofc.
Response mẫu
{
"status": "success",
"teams": [
{ "rank": 1, "team": "Argentina", "points": 1889.02, "change": 0 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Xổ số 3 miền
GET /api/v1/traditional
Kết quả xổ số kiến thiết ba miền theo ngày, tự động cập nhật ngay trong khung giờ mở thưởng.
Cần API Key
Cache 1 phút
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
region
string
Có
mien-bac, mien-trung hoặc mien-nam.
date
string
Không
Ngày dạng YYYY-MM-DD. Mặc định mới nhất.
Response mẫu
{
"status": "success",
"region": "mien-bac",
"date": "2026-07-27",
"results": { "special": "48215", "first": "91043" }
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Vietlott
GET /api/v1/dientoan
Kết quả Mega 6/45, Power 6/55, Max 3D và Max 3D Pro kèm giá trị jackpot của kỳ tiếp theo.
Cần API Key
Cache 1 phút
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
game
string
Có
mega645, power655, max3d, max3dpro.
limit
integer
Không
Số kỳ gần nhất, tối đa 100.
Response mẫu
{
"status": "success",
"game": "power655",
"draws": [
{ "id": "01142", "date": "2026-07-26", "numbers": [3, 12, 25, 33, 41, 52], "bonus": 18 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Giá nông sản
GET /api/v1/nongsan
Giá nông sản hằng ngày tại các vùng trồng trọng điểm, kèm mức thay đổi so với ngày trước.
Cần API Key
Cache 6 giờ
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
type
string
Có
caphe, hotieu, cacao, caosu, lua, heohoi.
region
string
Không
Slug tỉnh hoặc vùng trồng.
Response mẫu
{
"status": "success",
"type": "caphe",
"unit": "VND/kg",
"items": [
{ "region": "Đắk Lắk", "price": 120500, "change": -1500 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Giá xăng dầu
GET /api/v1/fuel-prices
Giá bán lẻ niêm yết của Petrolimex theo vùng 1 và vùng 2, kèm ngày điều chỉnh của kỳ hiện tại.
Cần API Key
Cache 6 giờ
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
zone
integer
Không
Vùng 1 hoặc 2. Mặc định trả cả hai.
product
string
Không
ron95, e5ron92, diesel, dauhoa, mazut.
Response mẫu
{
"status": "success",
"effective_date": "2026-07-24",
"items": [
{ "product": "RON 95-III", "zone_1": 22450, "zone_2": 22890, "change": 320 }
]
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Tra cứu mã số thuế
GET /api/v1/tax
Thông tin pháp lý doanh nghiệp và cá nhân theo mã số thuế hoặc tên, lấy từ dữ liệu Tổng cục Thuế.
Cần API Key
Cache 24 giờ
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
q
string
Có
Mã số thuế hoặc tên doanh nghiệp.
type
string
Không
doanh-nghiep hoặc ca-nhan.
Response mẫu
{
"status": "success",
"tax_code": "0312345678",
"name": "Công ty TNHH TechVina",
"address": "Quận 1, TP. Hồ Chí Minh",
"status_text": "Đang hoạt động"
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.
Tài liệu · Thời tiết & AQI
GET /api/v1/thoitiet
Nhiệt độ, độ ẩm, sức gió và chỉ số AQI hiện tại của 63 tỉnh, kèm dự báo tối đa 7 ngày.
Cần API Key
Cache 10 phút
RESTful JSON
Tham số truy vấn
Tham số
Kiểu
Bắt buộc
Mô tả
province
string
Có
Slug tỉnh hoặc thành phố.
forecast
integer
Không
Số ngày dự báo, tối đa 7.
Response mẫu
{
"status": "success",
"province": "TP. Hồ Chí Minh",
"current": { "temp": 32, "humidity": 74, "aqi": 61 }
}
Mã lỗi
401
invalid_api_key
Khoá không tồn tại hoặc đã bị thu hồi.
403
plan_not_allowed
Gói hiện tại chưa được mở endpoint này.
429
rate_limit_exceeded
Vượt hạn mức phút hoặc ngày. Header Retry-After cho biết thời gian chờ.
404
resource_not_found
Tham số không khớp dữ liệu hiện có.