서비스 소개

KOSIS 공유서비스 소개 및 이용방법 안내를 제공합니다.

KOSIS 공유서비스란,KOSIS 통계정보를 웹 또는 모바일앱 개발에 활용할 수 있도록 인터페이스(API)를 개방 · 제공하는 서비스입니다.

소개

KOSIS 에서 서비스하고 있는 통계정보를 외부(기관, 사용자)에서 사용할 수 있도록 열어 놓은 개방형 API(Application Programming Interface) 기능입니다.
XML, JavaScript 등 비교적 기본적인 웹기술을 이용하여 기관 및 사용자의 웹페이지에서 국가통계포털의 통계정보를 활용할 수 있도록 지원합니다.
더 나아가 고급사용자들은 여러가지 서비스를 혼합한 창의적인 애플리케이션(MashUp)을 제작할 수 있습니다.
제공되는 서비스 대상은 통계목록, 통계자료, 대용량 통계자료, 통계설명자료, 통계표설명, KOSIS통합검색, 통계주요지표 7가지이며, 자료 제공형태는 SDMX, JSON, XLS, XML이고
모든 서비스는 HTTP 프로토콜을 이용한 REST 방식으로 통신합니다.

  • 1) 통계목록

    통계표 서비스 목록으로서 레벨 형태로 구성

    • 자료 제공형태 : SDMX, JSON
    • 데이터 호출 제한 : 40,000 건
    통계목록 이미지
  • 2) 통계자료

    통계자료는 통계표의 수치데이터 및 메타정보(분류, 항목, 단위등)로서 통계자료를 호출하는 단위에 따라서 통계자료와 대용량 통계자료로 구분

    • 통계자료 : 통계표 전체, 분류/항목 전체 등 통계 자료를 한번에 호출
      • 자료 제공형태 : SDMX, JSON
      • 데이터 호출 제한 : 40,000 건
    • 대용량 통계자료 : 통계표 전체, 분류/항목 전체 등 대용량 자료를 한번에 호출
      • 자료 제공형태 : SDMX, XLS
      • 데이터 호출 제한 : 40,000 건

        - SDMX : 40,000 건
        - XLS : 200,000 건

    통계자료 이미지
  • 3) 통계설명자료

    통계조사에 대한 상세 설명정보(조사명, 통계종류, 법적근거, 조사목적, 조사주기 등)

    • 자료 제공형태 : XML, JSON
    • 데이터 호출 제한 : 40,000 건
    통계설명자료 이미지
  • 4) 통계표 설명

    통계표에 대한 상세 설명정보(통계표명, 수록정보, 분류/항목정보 등)

    • 자료 제공형태 : XML, JSON
    • 데이터 호출 제한 : 40,000 건
    통계표 설명 이미지
  • 5) KOSIS 통합검색

    KOSIS 통합검색 결과 제공

    • 자료 제공형태 : JSON
    • 데이터 호출 제한 : 40,000 건
    KOSIS 통합검색 이미지
  • 6) 통계주요지표

    • 자료 제공형태 : XML, JSON
    • 데이터 호출 제한 : 40,000 건
    통계주요지표 이미지

이용방법

통계목록·통계자료·대용량 통계자료·통계설명·통계표 설명·KOSIS 통합검색·통계주요지표 이용방법 이미지
통계표선택 : 선택한 통계표 및 분류/항목정보가 파라메터로 URL에 포함되며, 생성된 URL의 파라메터(분류, 항목코드)를 변경해가며 호출이 가능합니다. 단, 통계표의 메타정보 변경(항목, 분류값 삭제 등)시 확인이 불가합니다.
자료등록 : 통계표 등록 및 등록한 통계표에 대한 상세설정 정보를 등록하여만 이용이 가능(URL변경 불가)합니다. 단, 통계표의 메타정보 변경(항목, 분류값 삭제 등)시 등록한 정보에 의해 변경된 메타정보를 확인할 수 있습니다.