Dự báo thời tiết API

Dự báo thời tiết cho 34 tỉnh thành Việt Nam hoặc toạ độ bất kỳ: hiện tại, 24 giờ tới và tới 9 ngày, bằng tiếng Việt và tiếng Anh.

GEThttps://apibox.io.vn/v1/weather
Dữ liệu & JSON▶ Dùng thử online

API thời tiết trả về dự báo cho một tỉnh (mã hoặc tên: province=hcm, Hà Nội, 68) tại trung tâm hành chính sau sáp nhập 2025, hoặc cho lat / lon bất kỳ. Phản hồi gồm thời tiết hiện tại (nhiệt độ, độ ẩm, gió theo m/s và km/h kèm hướng, độ che phủ mây, áp suất, lượng mưa và tình trạng như “Mưa rào” / “Rain showers”), dự báo từng giờ cho 24 giờ tới và tóm tắt từng ngày với nhiệt độ thấp nhất, cao nhất, lượng mưa, tình trạng chính trong tối đa 9 ngày. Thời gian theo giờ Việt Nam.

Dữ liệu dự báo của MET Norway (Viện Khí tượng Na Uy, api.met.no), mô hình toàn cầu được dùng miễn phí cho mục đích thương mại theo giấy phép CC BY 4.0: hãy hiển thị dòng ghi nguồn trong attribution. Kết quả được cache theo vị trí (toạ độ làm tròn khoảng 1 km) đến lần cập nhật tiếp theo của nguồn.

Với cảnh báo bão và bản tin dự báo chính thức tại Việt Nam, hãy tham khảo Trung tâm Dự báo Khí tượng Thủy văn Quốc gia (nchmf.gov.vn).

Tham số

TênVị tríKiểuBắt buộcMặc định
provincequery|pathstringkhôngMã hoặc tên tỉnh (79, hcm, Đà Nẵng).
latquerynumberkhôngVĩ độ (kèm lon).
lonquerynumberkhôngKinh độ.
daysquerynumberkhông7Số ngày dự báo (1–9).

Ví dụ

curl "https://apibox.io.vn/v1/weather?province=hcm&days=3" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kết quả trả về

{
  "location": {
    "lat": 10.78,
    "lon": 106.7,
    "province_code": "79",
    "province": "Thành phố Hồ Chí Minh",
    "location": "TP. Hồ Chí Minh"
  },
  "timezone": "Asia/Ho_Chi_Minh",
  "current": {
    "time": "2026-11-10T23:00:00+07:00",
    "temperature": 26.4,
    "humidity": 90.5,
    "wind_speed": 1.8,
    "wind_kmh": 6.5,
    "wind_direction": "NW",
    "cloud_cover": 100,
    "pressure": 1012.9,
    "precipitation_mm": 0,
    "condition": {
      "symbol": "cloudy",
      "vi": "Nhiều mây",
      "en": "Cloudy"
    }
  },
  "hourly": [
    "…24 hours…"
  ],
  "daily": [
    {
      "date": "2026-11-11",
      "min": 24.8,
      "max": 31.8,
      "precipitation_mm": 4.8,
      "condition": {
        "symbol": "rain",
        "vi": "Mưa",
        "en": "Rain"
      }
    },
    "…"
  ],
  "attribution": "Weather data: MET Norway (api.met.no), CC BY 4.0"
}

Ứng dụng

  • Widget thời tiết trên website du lịch, giao hàng, sự kiện
  • Lên kế hoạch công việc ngoài trời, vận chuyển theo tỉnh
  • Chatbot trả lời “thời tiết Hà Nội ngày mai”
  • Dashboard nông nghiệp, logistics

Hỏi đáp

Có xem thời tiết theo phường xã được không?

Truyền toạ độ bằng lat và lon. Tỉnh dùng toạ độ của trung tâm hành chính.

Bao lâu cập nhật một lần?

MET Norway cập nhật dự báo nhiều lần mỗi ngày; API cache từng vị trí đến lần cập nhật tiếp theo (thường dưới một giờ).

Có cần ghi nguồn không?

Có, dữ liệu theo CC BY 4.0: hiển thị “Weather data: MET Norway” (trường attribution).

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →