⛅ Weather API · api.digiviet.vn

API thời tiết miễn phí cho 34 tỉnh/thành Việt Nam. Dữ liệu: Open-Meteo, múi giờ Asia/Ho_Chi_Minh, cache 10 phút.

Không cần API keyCORS mở (*)JSON UTF-8

GET /api/cities

Danh sách 34 tỉnh/thành (tên, slug, tọa độ).

GET /api/regions

34 tỉnh/thành xếp theo 7 vùng miền (Đông Bắc Bộ, Tây Bắc Bộ, Đồng bằng sông Hồng, Bắc Trung Bộ, Nam Trung Bộ, Đông Nam Bộ, Đồng bằng sông Cửu Long).

Thử ngay →

GET /api/current

Thời tiết hiện tại: nhiệt độ, cảm giác như, độ ẩm, gió, tầm nhìn, điểm sương, UV, mô tả tiếng Việt.

Tham số	Mô tả
`city`	slug tỉnh/thành, VD `ha-noi`
`lat`, `lon` (+`name`)	tọa độ tùy ý (thay cho city)

Thử: Hà Nội → Thử: TP.HCM →

GET /api/forecast

Gộp current + 24 giờ tới + dự báo ngày (mặc định 7 ngày).

Tham số	Mô tả
`city` / `lat`,`lon`	như trên
`days`	số ngày dự báo, 1–8 (mặc định 7)

Thử: Đà Nẵng →

GET /api/hourly

Dự báo theo giờ (tham số hours, 1–48, mặc định 24).

Thử: Huế →

GET /api/highlights

Thời tiết hiện tại của 12 tỉnh nổi bật — dùng cho trang chủ thoitiet.digiviet.vn.

Thử ngay →

GET /api/search

Tìm tỉnh/thành theo tên (không dấu cũng được). VD: /api/search?q=ha noi

Thử ngay →

Ví dụ response /api/current

{
  "city": { "name": "Hà Nội", "slug": "ha-noi", "lat": 21.0285, "lon": 105.8542 },
  "temperature": 27, "feels_like": 30, "humidity": 88,
  "description": "Mây rải rác", "icon": "partly-night",
  "wind_speed": 7.3, "visibility": 10, "uv_index": 0, "dew_point": 25
}