자료실
공공데이터APIofficial

KOSIS OpenAPI

국가승인통계 표와 지표를 JSON·XML 등으로 제공하는 KOSIS 공식 API

자료 등록 2026년 7월 8일

한눈에 보기

공식 검증 2026년 8월 29일

프로토콜
REST · JSON
인증
KOSIS OpenAPI 인증키
비용
무료 · 호출 제한 적용
제공 상태
정식 제공
공식 빠른 시작공식 빠른 시작 · https://kosis.kr/openapi/introduce/introduce_01List.do

Use cases

이럴 때 이렇게 연결합니다

먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.

추천 구성 · Situation 01

표마다 분류와 시점이 달라 필요한 국가통계를 반복 조회하고 재가공해야 하는 업무

어떤 어려움인가
공식 통계로 시장 규모를 설명하는 기획팀이 자주 마주치는 문제입니다. 구체적으로는 '표마다 분류와 시점이 달라 필요한 국가통계를 반복 조회하고 재가공해야 하는 업무' 상황입니다.
이렇게 해결합니다
KOSIS OpenAPI 단계에서는 요청과 응답 필드를 작은 범위로 맞춥니다. 입력 범위는 '통계표 ID, 분류값, 기간, 단위'입니다. 필요한 필드만 골라 '지표명·단위·기준 시점이 붙은 비교 데이터' 형태로 정리합니다.
왜 연결하는가
처음에는 KOSIS OpenAPI 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
마지막 확인
검토 대상은 '지표명·단위·기준 시점이 붙은 비교 데이터'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
Sequence입력부터 검토 결과까지
  1. 01 · 입력작은 입력 범위통계표 ID, 분류값, 기간, 단위
    업무 조건
  2. 02 · 현재 자료KOSIS OpenAPIAPI 요청: 입력 범위는 '통계표 ID, 분류값, 기간, 단위'입니다. 필요한 필드만 골라 '지표명·단위·기준 시점이 붙은 비교 데이터' 형태로 정리합니다.
    처리 결과
  3. 03 · 사람 확인담당자 검토검토 대상은 '지표명·단위·기준 시점이 붙은 비교 데이터'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.
    확인 완료
  4. 04 · 결과검토용 결과지표명·단위·기준 시점이 붙은 비교 데이터

Result

이 흐름으로 남는 값

첫 요청

curl "https://kosis.kr/openapi/YOUR_KOSIS_ENDPOINT?method=getList&apiKey=YOUR_KOSIS_API_KEY&format=json&YOUR_REQUIRED_PARAMS"

무엇이고 왜 필요한가

KOSIS OpenAPI는 국가통계포털의 통계표·지표·분류와 수치를 프로그램에서 조회하는 공식 API입니다. 화면에 보이는 숫자만 복사하지 않고 표 코드·항목·단위·시점·주석을 함께 가져와 재현 가능한 통계 분석을 만들 때 사용합니다.

할 수 있는 일

  • 통계표 목록과 수치를 조건별로 조회합니다.
  • 국가 통계 지표를 대시보드와 분석 파이프라인에 연결합니다.

시작 전 확인

  • OpenAPI 사용 신청과 통계표 코드·항목·기간 파라미터를 확인합니다.
  • 인증·비용 조건은 KOSIS OpenAPI 인증키, 무료 · 호출 제한 적용이며 제공 상태는 정식 제공입니다.
  • 첫 요청은 공식 샘플과 테스트 자격으로 실행해 정상 응답·오류·호출 제한을 함께 확인합니다.

잘 맞는 경우

  • 정책·시장 리서치, 공공 보고서, 통계 대시보드.

주의점

  • 통계표 개편과 단위·주석·잠정치 여부를 응답 값과 함께 보존합니다.
  • API 키는 브라우저 코드나 공개 예제에 넣지 않고 서버 비밀값으로 보관하며, 호출 실패·재시도·사용량을 기록합니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.

문의하기