공공 데이터 API 키 발급 완전 가이드 — 법제처·공공데이터포털·KOSIS·OpenDART·ECOS 5종

법령·통계·기업 공시·경제 지표 같은 공공 데이터를 코드로 자동 수집하려면, 사이트마다 발급받아야 하는 게 있습니다. 바로 API 인증키(Authentication Key)입니다. 인증키 없이는 어떤 요청을 보내도 해당 키는 등록되지 않은 키입니다 에러만 돌아옵니다.

문제는 사이트마다 가입 절차도, 승인 시간도, 키 보관 위치도 제각각이라는 점입니다. 이 글에서는 한국에서 가장 자주 쓰이는 5개 공공 API 사이트의 인증키 발급 절차를 동일한 구조로 정리합니다.

이 글이 필요한 분: 공공 데이터로 사이드 프로젝트를 시작하려는 분, Claude·n8n·자동화 스크립트에서 공공 API를 호출하려는 분, 학교·회사 과제로 법령·통계·공시 데이터가 필요한 분.

다루는 5개 사이트는 다음과 같습니다.

사이트	데이터	승인 시간	인증 방식
법제처 국가법령정보	법률·시행령·시행규칙 원문	1~2일	이메일 ID 기반
공공데이터포털 (data.go.kr)	정부 부처 통합 API 수천 종	즉시~1일	Service Key
KOSIS 국가통계포털	통계청·각 부처 통계	즉시 (자동승인)	API Key
OpenDART (금감원 전자공시)	상장사 공시·재무제표	개인 즉시 / 기업 검토 후	API Key
한국은행 ECOS	거시경제·금리·환율 통계	즉시	API Key

각 사이트의 키 발급은 한 번만 해 두면 계속 재사용할 수 있습니다. 한 시간만 투자해 5개 모두 받아두는 걸 권합니다.

---

1. 법제처 국가법령정보 OPEN API#

법률·대통령령·총리령·부령·자치법규 등 거의 모든 한국 법령의 조문 원문과 메타데이터를 가져올 수 있습니다. 법무 챗봇·계약서 자동 검토·규제 모니터링 같은 프로젝트의 가장 기본 데이터 소스입니다.

발급 절차#

1. 국가법령정보 공동활용 사이트 접속 — open.law.go.kr

2. 회원가입 — 우측 상단 회원가입 메뉴. 일반·기업·기관 회원 중 선택. 이메일 인증 필요.

   [스크린샷: open.law.go.kr 메인 화면 + 회원가입 진입 위치]

3. 로그인 후 OPEN API 신청 — 상단 메뉴의 OPEN API → OPEN API 활용신청

   [스크린샷: OPEN API 활용신청 폼 — 활용 목적·서비스 선택 화면]

4. 활용 목적 작성 후 제출 — 어떤 목적으로 어떤 법령 데이터를 쓸지 간단히 기술. “개인 학습·사이드 프로젝트”로 적어도 대부분 승인됩니다.

5. 승인 대기 — 영업일 기준 1~2일이 걸립니다. 승인되면 가입 시 입력한 이메일로 알림이 옵니다.

6. 인증 ID 확인 — 마이페이지 → OPEN API 신청현황에서 발급된 ID를 확인합니다. 다른 사이트와 달리 이메일 ID 형태로 발급됩니다 (예: myname@example.com을 그대로 사용).

호출 시 주의#

요청 URL은 https://www.law.go.kr/DRF/lawSearch.do?OC=<이메일ID>&target=law&type=XML&query=도로교통법 형식입니다. OC 파라미터에 이메일 앞부분(@ 앞)만 넣는 사이트도 있고 전체를 넣는 사이트도 있어 가이드 문서를 꼭 확인하세요.

📖 국가법령정보 공동활용 OPEN API 가이드

---

2. 공공데이터포털 (data.go.kr)#

행정안전부가 운영하는 부처 통합 포털입니다. 기상청 날씨, 국토부 부동산, 복지부 의료기관, 식약처 약품 정보 등 수천 개의 API가 한 군데 모여 있습니다. 한국 공공 API의 출발점이라 보면 됩니다.

발급 절차#

1. 포털 접속 — data.go.kr

2. 회원가입 — 일반/기업/공공기관 중 선택. 휴대폰 본인인증 또는 i-PIN 필요.

   [스크린샷: data.go.kr 메인 + 회원가입 위치]

3. API 검색 — 메인 검색창에 원하는 데이터 키워드 입력 (예: “기상청 단기예보”). 결과에서 OPEN API 탭을 클릭.

   [스크린샷: API 상세 페이지의 “활용신청” 버튼]

4. 활용신청 — API 상세 페이지의 활용신청 버튼 클릭 → 활용 목적·라이선스 동의·자동승인 여부 확인 후 신청.

5. 승인 — 자동승인 API는 즉시, 심사 API는 1영업일 이내. 대부분 자동승인입니다.

6. 인증키 확인 — 우측 상단 마이페이지 → 오픈API → 인증키 발급현황. 일반 인증키(Encoding)와 일반 인증키(Decoding) 두 가지가 보입니다.

   [스크린샷: 마이페이지 인증키 발급현황 — Encoding/Decoding 키 표시 영역]

호출 시 주의#

• 개발계정은 일일 호출 제한이 있습니다(보통 1만 건). 제한이 부족하면 운영계정 전환을 신청합니다.
• API마다 Encoding과 Decoding 중 하나만 동작하는 경우가 많습니다. 한쪽이 401 에러를 내면 다른 쪽으로 바꿔 시도해 보세요.
• API 신청은 PC에서만 지원됩니다(모바일에서는 신청 버튼이 비활성화).

---

3. KOSIS 국가통계포털 OpenAPI#

통계청이 운영하는 국가통계포털의 OpenAPI입니다. 인구·경제활동·물가·산업 통계 등 공식 통계 시계열을 한 번에 가져올 수 있습니다. 공공데이터포털에도 일부 API가 있지만, KOSIS 자체 OpenAPI가 자료 폭이 훨씬 넓습니다.

발급 절차#

1. KOSIS 공유서비스 접속 — kosis.kr/openapi

2. 회원가입 — 우측 상단의 회원가입. KOSIS 본 사이트와 별개의 공유서비스 계정입니다.

   [스크린샷: kosis.kr/openapi 메인 + 회원가입 위치]

3. 로그인 후 활용신청 — 활용신청 메뉴 → 사용할 서비스(통계자료 OpenAPI 등) 선택 → 활용 목적·예상 호출량 기재.

   [스크린샷: 활용신청 폼 화면]

4. 자동 승인 — 일반 신청은 자동 승인입니다. 즉시 사용자 인증키가 발급됩니다.

5. 인증키 확인 — 마이페이지 → OpenAPI 인증키 관리. 한 계정당 하나의 인증키가 발급되며, 모든 신청 서비스에 공통 사용합니다.

   [스크린샷: 인증키 관리 화면]

호출 시 주의#

요청은 https://kosis.kr/openapi/Param/statisticsParameterData.do?method=getList&apiKey=<KEY>&... 형식이며, 파라미터 조합이 까다롭습니다. 통계표 ID(tblId), 분류 코드(itmId), 시점(prdSe, startPrdDe)을 정확히 맞춰야 데이터가 옵니다. KOSIS 사이트에서 통계표를 먼저 찾아 “OpenAPI” 버튼으로 파라미터 조합을 자동 생성해 쓰는 게 가장 빠릅니다.

📦 itda-skills의 kosis 스킬에 호출 예제와 자주 쓰는 통계표 정리가 있습니다.

---

4. OpenDART (금융감독원 전자공시)#

금융감독원이 운영하는 전자공시시스템 DART의 OpenAPI입니다. 상장사 사업보고서·반기/분기 보고서·재무제표·주요사항 보고서를 모두 코드로 가져올 수 있습니다. 주식·재무 분석 프로젝트에서 가장 많이 쓰이는 데이터 소스입니다.

발급 절차#

1. OpenDART 접속 — opendart.fss.or.kr

2. 회원가입 — 이메일 입력 → 약관 동의 → 이메일 인증 링크 클릭으로 가입 완료. 휴대폰 인증은 없고 이메일만으로 가입됩니다.

   [스크린샷: OpenDART 메인 + 회원가입 진입 위치]

3. 로그인 후 인증키 신청 — 상단 메뉴 인증키 신청/관리 → 인증키 신청.

   [스크린샷: 인증키 신청 폼]

4. 신청 정보 입력 — 이용 기관/이용 목적/신청자 정보를 기재. 개인은 “개인”으로 선택.

5. 즉시 발급(개인) — 개인 신청자는 즉시 인증키가 발급됩니다. 기업 신청은 사업자등록증 검토 후 1~2일 소요.

6. 인증키 확인 — 인증키 신청/관리 → 오픈API 이용현황에서 발급된 키 확인 및 일일 호출량 모니터링.

   [스크린샷: 오픈API 이용현황 화면 — 인증키와 호출량 그래프]

호출 시 주의#

• 일일 호출 한도는 2만 건입니다. 대량 백테스트가 필요하면 호출을 분산하거나 캐싱 전략을 세워야 합니다.
• 일부 API(재무제표 원본 XBRL 등)는 응답이 ZIP 파일이라 일반적인 JSON 파싱과 다릅니다. 가이드의 응답 예시를 꼭 먼저 확인하세요.

📦 itda-skills의 dart 스킬에서 자주 쓰는 호출 패턴과 회사명 → 회사코드 변환 방법을 다룹니다.

---

5. 한국은행 ECOS 경제통계시스템#

한국은행이 제공하는 거시경제·통화·외환·금리·국제수지 통계 OpenAPI입니다. 기준금리, 환율, GDP, 소비자물가지수 같은 핵심 지표를 표준 시계열로 받아올 수 있어 경제 분석 프로젝트의 필수 소스입니다.

발급 절차#

1. ECOS Open API 접속 — ecos.bok.or.kr/api

   위 링크는 안내한 ecos.bok.co.kr/api/(co.kr)와 약간 다릅니다. **공식 도메인은 bok.or.kr**입니다.

2. 회원가입 — 우측 상단 회원가입. 이메일·비밀번호만 있으면 즉시 가입됩니다.

   [스크린샷: ECOS Open API 메인 + 회원가입 위치]

3. 로그인 후 인증키 신청 — OpenAPI 메뉴 → 인증키 신청. 활용 목적과 예상 사용량을 간단히 적습니다.

   [스크린샷: 인증키 신청 폼]

4. 즉시 발급 — 가입과 동시에 인증키가 자동 부여되며, 1일 이내 API 호출이 가능합니다(가입 직후 호출하면 일시적으로 막혀 있는 경우가 있어요).

5. 인증키 확인 — 마이페이지 → 인증키 관리에서 키 확인 및 호출량 조회.

호출 시 주의#

요청은 https://ecos.bok.or.kr/api/StatisticSearch/<KEY>/json/kr/1/100/<통계표코드>/... 형식입니다. 통계표 코드는 ECOS 사이트의 통계검색에서 찾을 수 있고, 빈도(연/분기/월/일)별로 코드가 다르니 주의합니다.

📦 itda-skills의 ecos 스킬에 자주 쓰는 거시지표 코드와 호출 예제가 정리돼 있습니다.

---

키 보관과 사용 팁#

5개 모두 발급받았다면, 이제 인증키들이 흩어져 있을 겁니다. 다음 원칙으로 보관하면 사고를 줄일 수 있습니다.

• .env 파일에 모아두기 — 프로젝트 루트의 .env에 LAW_API_KEY=..., DATA_GO_KR_KEY=... 식으로 저장합니다.
• .gitignore에 .env 추가 필수 — 커밋된 키는 GitHub Push Protection이 차단하지만, 이미 푸시된 후라면 즉시 재발급(rotate)해야 합니다.
• 호출량 모니터링 — 각 사이트 마이페이지에서 일일 호출량을 가끔 확인하세요. 봇이 무한 루프에 빠지면 하루 한도를 한 시간 만에 소진합니다.
• 키 분리 — 회사 프로젝트와 개인 프로젝트는 가능하면 별도 계정·별도 키로 운영합니다. 한쪽에서 한도 초과·차단이 일어나도 다른 쪽이 영향받지 않습니다.

---

다음 단계#

이제 5개 사이트의 인증키가 모두 손에 있습니다. 그다음으로 추천하는 흐름은 다음과 같습니다.

1. 간단한 호출 테스트 — curl 한 줄로 각 API에 한 번씩 요청을 보내 응답을 확인합니다.
2. Python·n8n·Claude로 자동화 — 매일 환율을 받아 텔레그램으로 알림 보내기, 관심 종목의 새 공시를 메일로 받기 같은 작은 자동화부터 시작합니다.
3. 스킬 활용 — itda-skills의 dart · ecos · kosis 스킬은 위 인증키를 그대로 받아 호출 패턴까지 정리해 둔 가이드입니다. 직접 코드를 짜기 전에 한 번 훑어보면 시행착오를 크게 줄일 수 있어요.

공공 데이터는 인증키 발급이 가장 큰 진입 장벽입니다. 한 번 넘어두면 그다음부터는 데이터를 어떻게 엮을지에만 집중할 수 있으니, 미루지 말고 오늘 한 번에 받아두시길 권합니다.

---

Sources

• 국가법령정보 공동활용 OPEN API 가이드
• 공공데이터포털 이용가이드
• KOSIS 공유서비스 OpenAPI
• 전자공시 OPENDART 시스템
• 한국은행 Open API 서비스