--- title: "공공 데이터 API 키 발급 완전 가이드 — 법제처·공공데이터포털·KOSIS·OpenDART·ECOS 5종" description: "법령·통계·공시·경제 데이터를 코드로 가져오려면 가장 먼저 필요한 게 API 인증키입니다. 한국에서 가장 많이 쓰이는 5개 공공 API 사이트의 회원가입부터 인증키 발급까지 단계별로 정리했습니다." created_at: 2026-04-28 category: guide tags: ["공공데이터", "API", "인증키", "법제처", "data.go.kr", "KOSIS", "kosis", "OpenDART", "dart", "ECOS", "ecos", "한국은행"] published: true --- 법령·통계·기업 공시·경제 지표 같은 공공 데이터를 **코드로 자동 수집**하려면, 사이트마다 발급받아야 하는 게 있습니다. 바로 **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](https://open.law.go.kr/LSO/main.do) 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 가이드](https://open.law.go.kr/LSO/openApi/guideList.do) --- ## 2. 공공데이터포털 (data.go.kr) 행정안전부가 운영하는 **부처 통합 포털**입니다. 기상청 날씨, 국토부 부동산, 복지부 의료기관, 식약처 약품 정보 등 **수천 개의 API**가 한 군데 모여 있습니다. 한국 공공 API의 출발점이라 보면 됩니다. ### 발급 절차 1. **포털 접속** — [data.go.kr](https://www.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](https://kosis.kr/openapi/) 2. **회원가입** — 우측 상단의 회원가입. KOSIS 본 사이트와 별개의 공유서비스 계정입니다. > [스크린샷: kosis.kr/openapi 메인 + 회원가입 위치] 3. **로그인 후 활용신청** — `활용신청` 메뉴 → 사용할 서비스(통계자료 OpenAPI 등) 선택 → 활용 목적·예상 호출량 기재. > [스크린샷: 활용신청 폼 화면] 4. **자동 승인** — 일반 신청은 **자동 승인**입니다. 즉시 사용자 인증키가 발급됩니다. 5. **인증키 확인** — `마이페이지` → `OpenAPI 인증키 관리`. 한 계정당 하나의 인증키가 발급되며, 모든 신청 서비스에 공통 사용합니다. > [스크린샷: 인증키 관리 화면] ### 호출 시 주의 요청은 `https://kosis.kr/openapi/Param/statisticsParameterData.do?method=getList&apiKey=&...` 형식이며, **파라미터 조합이 까다롭습니다**. 통계표 ID(`tblId`), 분류 코드(`itmId`), 시점(`prdSe`, `startPrdDe`)을 정확히 맞춰야 데이터가 옵니다. KOSIS 사이트에서 통계표를 먼저 찾아 **"OpenAPI"** 버튼으로 파라미터 조합을 자동 생성해 쓰는 게 가장 빠릅니다. 📦 itda-skills의 [kosis 스킬](/skills/itda-gov/kosis)에 호출 예제와 자주 쓰는 통계표 정리가 있습니다. --- ## 4. OpenDART (금융감독원 전자공시) 금융감독원이 운영하는 전자공시시스템 DART의 OpenAPI입니다. **상장사 사업보고서·반기/분기 보고서·재무제표·주요사항 보고서**를 모두 코드로 가져올 수 있습니다. 주식·재무 분석 프로젝트에서 가장 많이 쓰이는 데이터 소스입니다. ### 발급 절차 1. **OpenDART 접속** — [opendart.fss.or.kr](https://opendart.fss.or.kr/) 2. **회원가입** — 이메일 입력 → 약관 동의 → **이메일 인증 링크 클릭**으로 가입 완료. 휴대폰 인증은 없고 이메일만으로 가입됩니다. > [스크린샷: OpenDART 메인 + 회원가입 진입 위치] 3. **로그인 후 인증키 신청** — 상단 메뉴 `인증키 신청/관리` → `인증키 신청`. > [스크린샷: 인증키 신청 폼] 4. **신청 정보 입력** — 이용 기관/이용 목적/신청자 정보를 기재. 개인은 "개인"으로 선택. 5. **즉시 발급(개인)** — 개인 신청자는 **즉시** 인증키가 발급됩니다. 기업 신청은 사업자등록증 검토 후 1~2일 소요. 6. **인증키 확인** — `인증키 신청/관리` → `오픈API 이용현황`에서 발급된 키 확인 및 일일 호출량 모니터링. > [스크린샷: 오픈API 이용현황 화면 — 인증키와 호출량 그래프] ### 호출 시 주의 - 일일 호출 한도는 **2만 건**입니다. 대량 백테스트가 필요하면 호출을 분산하거나 캐싱 전략을 세워야 합니다. - 일부 API(재무제표 원본 XBRL 등)는 응답이 ZIP 파일이라 일반적인 JSON 파싱과 다릅니다. 가이드의 응답 예시를 꼭 먼저 확인하세요. 📦 itda-skills의 [dart 스킬](/skills/itda-gov/dart)에서 자주 쓰는 호출 패턴과 회사명 → 회사코드 변환 방법을 다룹니다. --- ## 5. 한국은행 ECOS 경제통계시스템 한국은행이 제공하는 거시경제·통화·외환·금리·국제수지 통계 OpenAPI입니다. **기준금리, 환율, GDP, 소비자물가지수** 같은 핵심 지표를 표준 시계열로 받아올 수 있어 경제 분석 프로젝트의 필수 소스입니다. ### 발급 절차 1. **ECOS Open API 접속** — [ecos.bok.or.kr/api](https://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//json/kr/1/100/<통계표코드>/...` 형식입니다. 통계표 코드는 ECOS 사이트의 통계검색에서 찾을 수 있고, 빈도(연/분기/월/일)별로 코드가 다르니 주의합니다. 📦 itda-skills의 [ecos 스킬](/skills/itda-gov/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](/skills/itda-gov/dart) · [ecos](/skills/itda-gov/ecos) · [kosis](/skills/itda-gov/kosis) 스킬은 위 인증키를 그대로 받아 호출 패턴까지 정리해 둔 가이드입니다. 직접 코드를 짜기 전에 한 번 훑어보면 시행착오를 크게 줄일 수 있어요. 공공 데이터는 **인증키 발급이 가장 큰 진입 장벽**입니다. 한 번 넘어두면 그다음부터는 데이터를 어떻게 엮을지에만 집중할 수 있으니, 미루지 말고 오늘 한 번에 받아두시길 권합니다. --- **Sources** - [국가법령정보 공동활용 OPEN API 가이드](https://open.law.go.kr/LSO/openApi/guideList.do) - [공공데이터포털 이용가이드](https://www.data.go.kr/ugs/selectPublicDataUseGuideView.do) - [KOSIS 공유서비스 OpenAPI](https://kosis.kr/openapi/) - [전자공시 OPENDART 시스템](https://opendart.fss.or.kr/) - [한국은행 Open API 서비스](https://ecos.bok.or.kr/api/)