통계자료

통계자료 API를 이용하는 요청변수, 출력변수, 샘플데이터를 제공하며 통계표선택(URL 생성) 방법 (분류와 항목정보가 파라메터로 URL에 포함되어 파라메터를 변경해가며 이용 가능)과
자료등록(자료등록 URL 생성) 방법 (자료등록 후 이용하여야 하며 URL 변경 불가) 2가지 방법으로 활용 가능합니다. 출력포맷으로 JSON과 SDMX를 제공합니다.

개발가이드 다운로드

자료등록 방법

  • 요청URL

    https://kosis.kr/openapi/statisticsData.do?method=getList

  • 요청변수

    요청URL로 요청변수, 변수타입, 설명, 비고를 제공합니다
    요청변수 변수타입 설명 비고
    apiKey String 발급된 인증 key 필수
    userStatsId String 사용자 등록 통계표 필수
    prdSe String 수록주기 필수
    시점기준 startPrdDe String 시작수록시점 선택

    (시점기준 또는 최신자료기준 택1)
    ※설정이 없을경우 최근시점1개 조회

    endPrdDe String 종료수록시점
    최신자료기준 newEstPrdCnt String 최근수록시점 개수
    prdInterval String 수록시점 간격
    ex) 2019, 2017, 2015 등 2개 시점 간격으로 추출시 [2] 입력
    format String 결과 유형(json) 필수
    content String 헤더 유형(html, json) 선택

통계표선택 방법

  • 요청URL

    https://kosis.kr/openapi/Param/statisticsParameterData.do?method=getList

  • 요청변수

    요청URL로 요청변수, 변수타입, 설명, 비고를 제공합니다
    요청변수 변수타입 설명 비고
    apiKey String 발급된 인증 key 필수
    orgId String 기관 ID 필수
    tblId String 통계표 ID 필수
    objL1 String 분류1(첫번째 분류코드) 필수
    objL2 ~ objL8 String 분류2(두번째 분류코드) ~ 분류8(여덟째 분류코드) 선택
    itmId String 항목 필수
    prdSe String 수록주기 필수
    시점기준 startPrdDe String 시작수록시점 선택

    (시점기준 또는 최신자료기준 택1)
    ※설정이 없을경우 최근시점1개 조회

    endPrdDe String 종료수록시점
    최신자료기준 newEstPrdCnt String 최근수록시점 개수
    prdInterval String 수록시점 간격
    ex) 2019, 2017, 2015 등 2개 시점 간격으로 추출시 [2] 입력
    format String 결과 유형(json) 필수
    outputFields String 응답필드(출력변수 선택) 선택
  • 출력결과

    출력변수
    출력변수로 출력변수,내용,설명을 제공합니다
    출력변수 설명 형식 비고
    ORG_ID 기관코드 VARCHAR2(40)  
    TBL_ID 통계표ID VARCHAR2(40)  
    TBL_NM 통계표명 VARCHAR2(300)  
    C1 ~ C8 분류값 ID1 ~ 분류값 ID8 VARCHAR2(40) 2~8 분류값은
    없을 경우 생략
    C1_OBJ_NM ~ C8_OBJ_NM 분류명1 ~ 분류명8 VARCHAR2(3000)
    C1_OBJ_NM_ENG ~ C8_OBJ_NM_ENG 분류 영문명1 ~ 분류 영문명8 VARCHAR2(3000)
    C1_NM ~ C8_NM 분류값 명1 ~ 분류값 명8 VARCHAR2(3000)
    C1_NM_ENG ~ C8_NM_ENG 분류값 영문명1 ~ 분류값 영문명8 VARCHAR2(3000)
    ITM_ID 항목 ID VARCHAR2(40)  
    ITM_NM 항목명 VARCHAR2(3000)  
    ITM_NM_ENG 항목영문명 VARCHAR2(3000)  
    UNIT_ID 단위ID VARCHAR2(40)  
    UNIT_NM 단위명 VARCHAR2(1000)  
    UNIT_NM_ENG 단위영문명 VARCHAR2(1000)  
    PRD_SE 수록주기 VARCHAR2(20)
    PRD_DE 수록시점 VARCHAR2(8)  
    DT 수치값 VARCHAR2(100)  
    LST_CHN_DE 최종수정일 VARCHAR2(8)  
  • 통계자료 예제
    (JSP, R, Python)

    통계자료 예제 : 막대차트 이미지
    통계자료 예제 : 파이차트 이미지
    통계자료 예제 : 통계표 이미지
  • 샘플데이터 확인

    파라미터(Input)
    파라미터(Input)로 필드명,설명,조회조건을 제공합니다
    요청변수 설명 조회조건
    userStatsId 사용자 등록 통계표
    prdSe 수록주기
    startPrdDe 시점기준 시작수록시점
    endPrdDe 종료수록시점
    newEstPrdCnt 최신자료기준 최근수록시점 개수
    prdInterval 수록시점 간격
    결과(Output)
    JSON 결과