OPENAPI Detail

XML JSON

Meteorological Administration_Short-Term Forecast ((Old)_Neighborhood Forecast) inquiry service

This service provides access to ultra-short-term real-time information, ultra-short-term forecasts, short-term ((formerly) neighborhood) forecasts, and forecast version information. Ultra-short-term real-time information provides representative AWS observations for the forecast area, ultra-short-term forecasts provide forecasts for up to 6 hours from the forecast time, and short-term forecasts provide forecasts that are detailed in both time and space by expanding the forecast period to the number of characters and detailing the forecast unit (3 hours → 1 hour). Short-term forecasts are announced by subdividing the forecast period and area into both time and space. To minimize user inconvenience due to regional time differences, the entire country is divided into 5km x 5km grids and provide detailed weather information centered on administrative districts such as townships, counties, and neighborhoods.

※ Application for use is only available on the PC version.

Meteorological Administration_Short-Term Forecast ((Old)_Neighborhood Forecast) inquiry service Information such as classification and provision of file data information system
Classified science Technology - Science and technology research Provided By
Department Department No
API Type REST Data Format JSON+XML
Usage 48345 Keyword Short-term forecast,Ultra-short-term live broadcast,Short-term forecast,Neighborhood forecast,townships and districts
Registered 2021-06-28 Edited 2025-11-19
Deliberation Type dev : allow / run : allow
Payment free
Scope of License
References 기상청41_단기예보 조회서비스_오픈API활용가이드_2510.zip

Function

  • Application for Use Development level : allowed / Operation level : allowed
  • Available traffic 100000 / Operational account can increase traffic by applying for use case registration
  • Requested Link http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0/getUltraSrtNcst
  • Service URL http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0

Request Parameter

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 1000 number of results per page
응답자료형식 dataType 4 Optional XML Request data format (XML/JSON) Default: XML
발표일자 base_date 8 Essential 20210628 Announced on June 28, '21
발표시각 base_time 4 Essential 0600 Announcement at 06:00 (on-time)
예보지점 X 좌표 nx 2 Essential 55 X coordinate value of the forecast point
예보지점 Y 좌표 ny 2 Essential 127 Y coordinate value of the forecast point

Response Element

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)
발표일자 baseDate 8 Essential 20210628 Announced on June 28, '21
발표시각 baseTime 6 Essential 0600 Announcement at 06:00 (every hour on the hour)
예보지점 X 좌표 nx 2 Essential 55 Entered forecast point X coordinate
예보지점 Y 좌표 ny 2 Essential 127 Entered forecast point Y coordinate
자료구분코드 category 3 Essential RN1 Data classification code
실황 값 obsrValue 2 Essential 0 RN1, T1H, UUU, VVV, WSD provided by mistake

Sample Code

Please check the sample code on your PC.