스킬.잇다

KOSIS 국가통계포털 Open API — 가입·키 발급 가이드

Last Verified: 2026-06-10 (kosis 스킬 GUIDE에서 이전 — 실화면 재검증 시 갱신)

  • 공식 사이트: https://kosis.kr/openapi/
  • 발급 키: KOSIS_API_KEY
  • Last Verified: 2026-06-10 (kosis 스킬 GUIDE에서 이전 — 실화면 재검증 시 갱신)

1. 가입 조건

  • KOSIS 일반 회원가입으로 충분합니다 (비용 없음).
  • 활용신청은 자동 승인이라 신청 즉시 사용할 수 있습니다.

2. 발급 절차

  1. kosis.kr/openapi 접속 → 회원가입 후 로그인
  2. 상단 메뉴 Open API → 활용신청 → 사용 목적·서비스명 입력 후 신청 (자동 승인, 즉시 이용 가능)
  3. 마이페이지 → 인증키 확인에서 키 복사

3. 키 ↔ 환경변수 매핑

항목환경변수
KOSIS 인증키KOSIS_API_KEY
KOSIS_API_KEY=발급받은_키

4. 한도·주의사항

  • 인증키는 Base64 형식이라 끝에 = 문자가 붙는 경우가 있습니다 — 복사할 때 끝 문자가 잘리면 인증 실패하므로 전체를 한 번에 복사하세요.
  • “활용신청이 필요합니다” 또는 인증 오류(코드 10/11/42)가 보이면 마이페이지에서 활용 상태와 인증키 만료 여부를 확인하세요 — 키가 만료되면 코드 11 오류가 납니다.
  • 대용량 일괄(배치) 다운로드는 제공되지 않습니다 — 기간·항목을 나눠 조회합니다.

이 설정을 쓰는 스킬

아래 스킬들이 이 키를 사용합니다 — 각 스킬 가이드의 발급 안내가 이 페이지로 연결돼 있습니다.