Service
Korea Meteorological Administration (KMA) weather provider via data.go.kr: short-term forecasts (단기예보/동네예보) for a KMA grid point from a specific announcement, ultra-short observations and ultra-short forecasts for the same grid points, plus forecast file version lookups.
98.54%30-day uptimeAvg response217ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-weather-forecast/forecast-version | Returns the generation version timestamp of KMA observation (odam), ultra-short forecast (vsrt), or short-term forecast (shrt) files near a requested base datetime, using the official getFcstVersion endpoint. Use when the caller needs to know when a forecast or observation file was last generated, e.g. to check freshness before querying it. Do NOT use to read weather values — use korea-weather-forecast:ultra-short-observation (observations), korea-weather-forecast:ultra-short-forecast (next few hours), or korea-weather-forecast:short-forecast (up to ~3 days) instead. Returns total_count, has_more, and items (file_type, version_at). | |
| POST | /v1/korea-weather-forecast/short-forecast | Returns the short-term forecast (단기예보, 동네예보) batch published at one announcement (base_date + base_time) for one 5km grid point (grid_x, grid_y): one row per (category, forecast_date, forecast_time), spanning up to ~3 days ahead across categories such as TMP (temperature), POP (precipitation probability), SKY (sky condition), PTY (precipitation type), REH (humidity), WSD (wind speed), and others. Backed by data.go.kr's KMA short-term forecast service (기상청_단기예보 조회서비스, getVilageFcst). Use when the caller needs the multi-day outlook for a grid point. Do NOT use for the weather observed right now — use korea-weather-forecast:ultra-short-observation instead. Do NOT use when only the next few hours matter — use korea-weather-forecast:ultra-short-forecast instead. Do NOT use for file generation timestamps — use korea-weather-forecast:forecast-version instead. base_date/base_time/grid_x/grid_y are all required — KMA publishes only 8 batches per day (base_time must be one of 02:00/05:00/08:00/11:00/14:00/17:00/20:00/23:00 KST) and only for specific grid coordinates, so all four must be known in advance (e.g. from a coordinate-conversion lookup and a recent announcement time). Returns total_count, has_more, and items (forecast_date, forecast_time, category, forecast_value). | |
| POST | /v1/korea-weather-forecast/ultra-short-forecast | Returns KMA ultra-short forecast (초단기예보) rows for one publication time and grid point: one row per (category, forecast_date, forecast_time) covering the next several hours, using the official getUltraSrtFcst endpoint. Use when the caller needs hour-by-hour conditions for the coming hours at a grid point (base_time is an HH:30 KST publication time). Do NOT use for the weather observed right now — use korea-weather-forecast:ultra-short-observation instead. Do NOT use for forecasts beyond the next few hours or for the 8-times-daily short-term batch — use korea-weather-forecast:short-forecast instead. Do NOT use for file generation timestamps — use korea-weather-forecast:forecast-version instead. Returns total_count, has_more, and items (forecast_date, forecast_time, category, forecast_value). |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
| POST | /v1/korea-weather-forecast/ultra-short-observation | Returns KMA ultra-short observations (초단기실황) for one hourly observation time and grid point, including category-coded temperature, precipitation, wind, humidity, and related observed values, using the official getUltraSrtNcst endpoint. Use when the caller needs the weather actually observed at a grid point at a given hour (base_time is an hourly HH:00 KST value). Do NOT use for future hours — use korea-weather-forecast:ultra-short-forecast (next few hours) or korea-weather-forecast:short-forecast (up to ~3 days) instead. Do NOT use for file generation timestamps — use korea-weather-forecast:forecast-version instead. Returns total_count, has_more, and items with one row per category (base_date, base_time, category, observed_value, grid_x, grid_y). |
