국가데이터처_KOSIS 지표정보 조회 서비스

'국가데이터처_KOSIS 지표정보 조회 서비스'는 국가데이터처가 운영하는 KOSIS(국가통계포털)의 방대한 통계 데이터를 외부 시스템 및 사용자가 원활하게 연동·활용할 수 있도록 지원하는 오픈 API(REST 방식) 서비스입니다.본 서비스는 KOSIS에서 엄선한 'KOSIS 100대 지표'를 비롯하여 인구, 가구, 고용, 노동, 경기, 물가, 가계 등 우리 사회의 각 부문에 걸친 국내 주요 통계 지표를 총망라하여 제공합니다. 이뿐만 아니라 북한의 통계 정보 및 국제(G20) 통계 지표까지 폭넓게 아우르고 있어, 국내외 경제·사회 트렌드를 다각도로 분석하는 데 유용합니다.사용자는 오픈 API를 통해 실시간으로 업데이트되는 데이터를 요청하여 JSON 또는 XML 형태로 안전하게 전달받을 수 있습니다. 이를 통해 복잡한 통계 데이터의 구조를 체계적으로 파악할 수 있으며, 공공 및 민간 영역의 개발자와 연구자들은 필요한 핵심 지표만을 효율적으로 선별하고 가공할 수 있습니다.궁극적으로는 해당 데이터를 기반으로 한 맞춤형 웹·앱 서비스 개발, 시각화 대시보드 구축, 학술 연구 및 데이터 기반의 정책 수립 등 다양한 지능형 서비스 및 비즈니스 모델 창출에 적극적으로 활용할 수 있습니다.

body header item items 결과메세지 결과코드 단위 수록시작시점 수록시점 개수 수록종료시점 수록주기 수록주기명 시점 전체 결과 수 종료시점+주기명 지역구분명 지표ID 지표명 통계수치 페이지 번호 한 페이지 결과 수 항목

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '결과유형=값' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '수록주기=값' \
  --data-urlencode '조회 기준 시점=값' \
  --data-urlencode '조회 시작 시점=값' \
  --data-urlencode '조회 시점 개수=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "결과유형": "값",
  "공공데이터포털에서 받은 인증키": "값",
  "수록주기": "값",
  "조회 기준 시점": "값",
  "조회 시작 시점": "값",
  "조회 시점 개수": "값",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "결과유형": "값",
    "공공데이터포털에서 받은 인증키": "값",
    "수록주기": "값",
    "조회 기준 시점": "값",
    "조회 시작 시점": "값",
    "조회 시점 개수": "값",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())