인증 방식
🔑 API Key
요금
무료
Base URL
kosis.kr/openapi
태그
통계, 인구
서비스 소개
통계청 국가통계포털(KOSIS)에서 제공하는 오픈 API입니다. 인구, 고용, 물가, 경제성장률, 산업별 현황 등 국가 공식 통계를 JSON으로 조회할 수 있습니다. 시계열 데이터도 지원하여 연도별 추이 분석이 가능합니다.
🚀 시작하기
- 1
KOSIS 회원가입
kosis.kr → 회원가입 → Open API 신청
- 2
통계 코드 확인
KOSIS 통계표 검색 → 공유 → API 연결하기에서 통계표 ID 확인
- 3
API 키 발급
오픈 API 신청 완료 후 API 목록에서 키 확인
💡 코드 예제
JavaScriptJavaScript
const KOSIS_KEY = process.env.KOSIS_API_KEY
async function getStatistics(statisticsCode: string) {
const url = new URL('https://kosis.kr/openapi/Param/statisticsParameterData.do')
url.searchParams.set('method', 'getList')
url.searchParams.set('apiKey', KOSIS_KEY!)
url.searchParams.set('itmId', 'T1')
url.searchParams.set('objL1', 'ALL')
url.searchParams.set('format', 'json')
url.searchParams.set('jsonVD', 'Y')
url.searchParams.set('prdSe', 'Y') // Y: 연간, M: 월간
url.searchParams.set('startPrdDe', '2020')
url.searchParams.set('endPrdDe', '2023')
url.searchParams.set('orgId', statisticsCode.split('_')[0])
url.searchParams.set('tblId', statisticsCode.split('_')[1])
const res = await fetch(url.toString())
return await res.json()
}