XML
JSON
Korea Meteorological Administration Short-term Forecast Notification Inquiry Service
QuickAISummary
About OpenAPI
Basic Information
Details Information
-
Description
A service that searches for weather overviews, land forecasts, and marine forecasts based on information from the announcing agency or forecast area (reference) A general short-term forecast is a forecast that is announced by subdividing the forecast period and area in terms of time and space. In order to minimize inconvenience to users due to differences in region and time, the country is divided into a grid of 5km x 5km intervals (149 east-west (745km) × 253 north-south (1.265km)), a total of 37,697, and detailed weather is announced at 3-hour intervals centered on administrative districts such as townships, counties, and dongs. Production cycle: Every 3 hours starting at 2:00 (02:00, 05:00, 08:00, 11:00, 14:00, 17:00, 20:00, 23:00, 8 times a day) Retention period: From 17:00 KST on October 30, 2008 (based on the date of enforcement) to the present. In the case of notifications, announcements are made at 05:00, 11:00, and 17:00, focusing on major cities.
-
API Type
REST
-
Data Format
JSON+XML
-
Spatial Range
-
-
Temporal Range
-
-
Keyword
Weather Overview,Land forecast,marine forecast,temperature,Sea conditions
-
Usage
0
-
Registered
2019-12-27
-
Edited
2026-03-26
Terms of Use & License Information
-
Payment
Free
-
Scope of License
Public Works Source Indication
-
Review Type
Development Stage: Auto Approval / Production Stage: Auto Approval
-
Available Traffic
Development account: 10,000 / Production account: Traffic can be increased upon request when registering a use case.
Reference Documents
-
기상청5_단기예보 통보문 조회서비스_오픈API활용가이드_241128.zip
Standard Metadata
※ Standard Metadata for Data Integration and Search.
Schema.orgUseful Information
List
API Basic Information
-
Application for Use
Development level : allowed / Operation level : allowed
-
Available traffic
Development account: 10,000 / Production account: Traffic can be increased upon request when registering a use case.
-
Requested Link
https://apis.data.go.kr/1360000/VilageFcstMsgService/getWthrSituation
-
Service URL
https://apis.data.go.kr/1360000/VilageFcstMsgService
Request Parameter
| Category(Korean) | Category(English) | Size | Division | Sample Data | Description |
|---|---|---|---|---|---|
| 서비스키 | ServiceKey | 4 | Essential | - | Authentication key received from public data portal |
| 페이지 번호 | pageNo | 4 | Essential | 1 | page number |
| 한 페이지 결과 수 | numOfRows | 4 | Essential | 10 | number of results per page |
| 응답자료형식 | dataType | 4 | Optional | XML | Request data format (XML/JSON) Default: XML |
| 발표관서 | stnId | 5 | Essential | 108 | 108 Korea Meteorological Administration, 109 Seoul Metropolitan Area (Seoul), etc. Refer to the attached Excel data (refer to the 'Overview' section value) |
Response Element
| Category(Korean) | Category(English) | Size | Division | Sample Data | Description |
|---|---|---|---|---|---|
| 결과코드 | resultCode | 2 | Essential | 00 | result code |
| 결과메시지 | resultMsg | 50 | Essential | OK | result message |
| 한 페이지 결과 수 | numOfRows | 4 | Essential | 10 | number of results per page |
| 페이지 번호 | pageNo | 4 | Essential | 1 | page number |
| 전체 결과 수 | totalCount | 4 | Essential | 3 | total number of results |
| 데이터 타입 | dataType | 4 | Essential | XML | Response data format (XML/JSON) |
| 발표관서 | stnId | 5 | Essential | 108 | announcement office |
| 발표시간 | tmFc | 12 | Essential | 202010131100 | year month date hour |
| 기상개황(종합) | wfSv1 | 4000 | Optional | 예제 참조 | Weather Overview (General) |
| 특보사항 | wn | 4000 | Essential | 예제 참조 | special notice |
| 예비특보 | wr | 4000 | Essential | 예제 참조 | preliminary advisory |