AIRS API — 날씨 데이터 개발자 API

AIRS가 수집·가공한 전 세계 날씨 · 대기질 · 해양 · 항공 · 한국 특보 데이터를 REST API로 제공합니다. 모든 응답은 JSON이며, 서버 캐시로 매우 빠르게 응답해요.

시작하기

인증

아래에서 키를 신청하고 발급받은 뒤, 쿼리 파라미터 또는 헤더로 전달하세요.

GET https://api.airs.kr/api/weather?lat=37.57&lon=126.98&key=발급받은키
# 또는 헤더로: X-API-Key: 발급받은키

응답 헤더	의미
`X-RateLimit-Limit`	내 키의 일일 호출 한도
`X-RateLimit-Used`	오늘 사용한 호출 수

공통 응답 구조: { "data": …, "meta": { "source", "ageMs" } } — meta.ageMs는 캐시된 데이터의 나이(ms)예요. 좌표는 WGS84 십진수(lat, lon).

엔드포인트

GET/api/weather현재 + 24시간 + 7일 예보

params: lat, lon — 한국 좌표는 기상청(KMA) 실측·예보가 자동 병합돼요.

{"data":{"current":{"temp":25,"feels":24,"hum":98,"wind":0,"code":61,"isDay":0,"rn1":0},
 "hourly":[{"label":"00시","t":26,"p":60,"code":61},…],
 "daily":[{"label":"오늘","code":65,"min":23,"max":26,"p":0},…]},"meta":{…}}

GET/api/air대기질 · 자외선

params: lat, lon

{"data":{"pm25":6,"pm10":7,"uv":0},"meta":{"source":"cache","ageMs":31259}}

GET/api/geocode전 세계 도시 검색

params: q — 한글·영문 도시명

{"results":[{"name":"도쿄","sub":"도쿄 도, 일본","lat":35.6895,"lon":139.6917},…]}

GET/api/history시간별 관측 이력

params: lat, lon, hours — 수집 대상 도시(아래 /api/cities)만 데이터가 있어요.

{"rows":[{"t":1787814000000,"temp":27,"feels":25,"hum":79,"wind":6,"code":2,"pm25":26,"pm10":28,"uv":"0.0","kr":1},…]}

GET/api/accuracyAIRS 예보 정확도 통계

params: 없음(전체 통계) 또는 lat, lon(도시별)

{"period":{"from":"2026-08-07","to":"2026-08-31"},
 "sources":{"main":[{"d":1,"n":628,"tmaxMAE":1,"tminMAE":0.7,"rainAcc":70},…]},…}

GET/api/cities관측 수집 도시 목록

{"cities":[{"name":"서울","lat":37.57,"lon":126.98},…]}  // 28개 도시

GET/api/aviation공항 METAR / TAF

params: icao — 예: RKSI(인천), RKPC(제주)

{"data":{"metar":{"icao":"RKSI","raw":"METAR RKSI 311030Z 06004KT …","cat":"MVFR","temp":23,…}},"meta":{…}}

GET/api/marine해양 — 파고 · 스웰 · 수온

params: lat, lon (해상 좌표)

{"data":{"ocean":true,"wave":0.54,"dir":181,"period":4.25,"swell":0.36,"sst":28.6},"meta":{…}}

GET/api/kr/alerts한국 기상특보 통보문

{"alerts":["○ 호우주의보 발표 : 2026년 08월 31일 00시 00분 …",…]}

GET/api/kr/tide조석(물때) — 가까운 관측소

params: lat, lon — 연안 좌표. 내륙이면 available:false

{"data":{"available":true,"station":…,"events":[…]},"meta":{…}}

GET/api/kr/living생활지수 — 자외선·대기확산·꽃가루

params: lat, lon (한국)

{"data":{"available":true,"area":"서울","uv":{"v":0,"grade":"낮음"},"diffusion":{"v":75,"grade":"좋음"},"pollen":{…}},"meta":{…}}

GET/api/kr/typhoon태풍 경로 (활동 시)

{"storms":[{"name":…, "track":[[lon,lat],…], "forecast":[[lon,lat],…]},…]}

키 신청

API 키 신청하기

신청 내용을 검토한 뒤 이메일로 키를 보내드려요 (보통 1~2일). 무료 키는 일일 호출 한도가 적용됩니다.