URL 상세 정보

대용량통계자료

대용량 통계자료 API를 이용하기 위한 요청변수, 출력정보, 샘플데이터를 제공합니다. 출력포맷으로 SDMX, XLS를 제공합니다.
데이터 출력건수가 40,000개 이상인 경우는 SDMX 제공은 불가하고, XLS로만 가능합니다.
또한, 데이터 출력건수가 20만개 이상인 경우는 XLS로도 제공이 불가하므로 이용건수를 줄여 사용하시기 바랍니다.

개발가이드 다운로드

  • 요청URL

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

  • 요청변수

    요청URL로 요청변수, 변수타입, 설명, 비고를 제공합니다
    요청변수 변수타입 설명 비고
    apiKey String 발급된 인증 key 필수
    userStatsId String 사용자 등록 통계표 필수
    type String SDMX의 유형(DSD) 필수
    format String 결과 유형(sdmx) 필수
    version String 결과값 구분 생략시 구버전으로 데이터 출력

  • 출력결과

    출력변수
    출력변수로 출력변수,내용,설명을 제공합니다
    출력변수 비고
    Header ID 기관코드_통계표ID
    Prepared 전송시간
    Sender Id 전송기관
    Name 전송기관명
    Contact Department 담당부서
    Telephone 담당부서 연락처
    Name 통계표명
    Source 출처
    Codelist Codelist Id 코드리스트ID
    Name 코드리스트명
    Description 코드리스트영문명
    Code Id 코드ID
    Name 코드명
    Concepts ConceptsScheme Id 컨셉스키마ID
    Name 컨셉스키마명
    Description 컨셉스키마영문명
    concept Id 컨셉ID
    Name 컨셉명
    Description 컨셉영문명
    DataStructures DataStructure Id 통계표ID
    Name 통계표명
    DataStructureComponents Dimension Id 디멘젼Id
    ConceptIdentity Id 컨셉객체Id

  • 샘플데이터 확인

    파라미터(Input)
    파라미터(Input)로 필드명,설명,조회조건을 제공합니다
    요청변수 설명 조회조건
    userStatsId 사용자 등록 통계표
    결과(Output)
    SDMX 결과
주기코드 및 시점

※ 주기에 따른 시점

주기 주기변수
(prdSe)		 시점변수 입력형식
(startPrdDe, endPrdDe)
일 D YYYYMMDD ex)20140101
월 D YYYYMM(MM:01~12) ex)201401
격월 M YYYYMM(MM:홀수월) ex)201401, 201403
분기 Q YYYYQQ(QQ:01～04) ex)201401
반기 S YYYYHH(HH:01,02) ex)201401
년 Y YYYY ex)2014
2년 Y YYYY ex)2014, 2016..
3년 Y YYYY ex)2014, 2017..
4년 Y YYYY ex)2014, 2018..
5년 Y YYYY ex)2014, 2019..
10년 Y YYYY ex)2014, 2024..
부정기 IR YYYY, YYYYMM, YYYYMMDD ex)2014, 20140101..