kosis-stats

What problem does it solve?

KOSIS(국가통계포털) Open API로 한국 공식 통계표를 직접 찾아보고, 표의 메타데이터와 기간·분류에 맞는 수치를 반복해서 조회하는 번거로움을 줄여줍니다.

Core Features & Use Cases

• 공식 통계표 검색(Search): 키워드로 통계표 후보를 찾아 통계표 ID(ORG_ID/TBL_ID)를 빠르게 확보합니다.
• 메타데이터 조회(Meta): 표의 분류 차원(OBJ/ITM), 항목, 단위 등을 확인해 올바른 파라미터로 데이터를 가져올 수 있게 합니다.
• 데이터 셀 조회(Data): 기간(연/월/분기 등)과 분류(필수 차원 포함)를 지정해 조회 전용으로 원시 수치를 가져옵니다.
• 대용량 조회(Bigdata, 선택): 큰 범위의 데이터를 받기 위해 사전 등록된 userStatsId 기반으로 대용량 endpoint를 사용합니다.

실제 사용 예:

• “1인 가구 비율” 통계표를 검색한 뒤, 메타를 확인하고 최근 5개년 또는 특정 연도 범위의 수치를 조회합니다.
• 특정 지역/분류 차원이 필요한 표에서 코드 오류(필수 분류 누락)를 메타 조회로 회복하는 흐름을 안내합니다.

Quick Start

Ask: “KOSIS에서 1인 가구 비율 통계표를 찾아서 2023~2024년 전국의 수치만 조회해줘.”