본문으로 건너뛰기

공공데이터 API, 활용 신청 순서와 업무 예시 5개

공공데이터 API를 업무에 붙이는 순서를 회원가입부터 운영계정 전환까지 5단계로 나누고, 사업자 상태 조회 · 특일 정보 · 주소 · 단기예보 · 기업기본정보 다섯 가지 예시와 상세 화면에 적힌 호출량, 자주 만나는 오류 코드 7개를 정리했습니다.

공공데이터 API, 활용 신청 순서와 업무 예시 5개

공공데이터 API는 공공데이터포털에서 쓰려는 API를 찾아 활용 신청을 하면 대부분 자동승인으로 바로 인증키가 나옵니다. 처음 받는 것은 개발계정이라 하루 호출량이 API마다 정해져 있고(예: 1만 건), 실제 업무에 붙이기 전에 활용사례를 등록해 운영계정 트래픽을 늘려 두어야 합니다. 거래처 사업자 상태 확인 · 공휴일 계산 · 주소 검색 · 날씨 · 기업 정보 조회처럼 지금 손으로 찾아보는 일이 먼저 바꿀 후보입니다.

공공데이터 API는 어떤 순서로 신청하나요

신청은 공공데이터포털(data.go.kr) 한 곳에서 합니다. API마다 상세 화면에 비용부과유무 · 이용허락범위 · 심의유형 · 트래픽이 적혀 있으니, 신청 전에 이 네 가지 항목부터 읽으세요.

단계할 일확인할 것
1. 회원가입공공데이터포털에 가입하고 로그인합니다기업회원은 신청할 때 프로젝트 서비스키와 개인 서비스키 가운데 고름
2. API 찾기데이터 목록에서 오픈 API를 검색합니다비용부과유무 · 이용허락범위 · 심의유형 · 트래픽
3. 활용 신청활용 목적을 적고 신청합니다개발단계가 자동승인이면 바로 승인
4. 호출 시험발급된 인증키를 요청에 넣어 한 번 호출합니다오류가 나면 아래 오류 코드표
5. 운영 전환활용사례를 등록하고 운영계정 트래픽 증가를 신청합니다운영단계가 심의승인인 API는 검토 시간

4단계는 가장 단순한 호출 하나로 확인합니다. 예를 들어 국세청 사업자등록 상태조회는 사업자등록번호를 배열로 보내면 계속사업자 · 휴업자 · 폐업자 여부와 과세유형, 폐업일을 돌려주고, 한 번에 100건까지 받습니다.

POST https://api.odcloud.kr/api/nts-businessman/v1/status?serviceKey=(발급받은 키)
Content-Type: application/json

{"b_no": ["(사업자등록번호 10자리)", "(사업자등록번호 10자리)"]}

업무에 바로 쓰는 공공데이터 API는 무엇이 있나요

사무실에서 사람이 사이트를 열어 확인하던 일 다섯 가지를 골랐습니다. 마지막 칸은 각 API 상세 화면에 적힌 조건입니다.

업무API(제공 기관)보내는 값 → 받는 값상세 화면에 적힌 조건
거래처 휴업 · 폐업 확인사업자등록정보 진위확인 및 상태조회(국세청)사업자등록번호 → 계속 · 휴업 · 폐업, 과세유형, 폐업일1회 100건 · 1일 100만 건, 국세청 자료와 30분 주기로 갱신(신규 개업자는 1~2일)
공휴일 · 영업일 계산특일 정보(한국천문연구원)연 · 월 → 날짜 · 명칭 · 공공기관 휴일 여부국경일 · 공휴일 · 기념일 · 24절기 제공, 개발계정 10,000
주소 검색실시간 주소정보 조회(행정안전부)검색어 → 도로명 · 지번 · 우편번호 · 영문 주소1 시스템 1 승인키, 신청 때 받은 승인키로 호출
날씨에 맞춘 일정 · 발주단기예보 조회서비스(기상청)예보 지점(격자) · 발표 시각 → 시간별 예보전국 5km 격자, 출처 표시 조건, 개발계정 10,000
거래처 기업 정보기업기본정보(금융위원회)법인등록번호 · 기업명 → 대표자 · 설립일 · 업종 등하루 한 번 갱신(실시간 아님), 개발계정 10,000

공시 원문까지 봐야 하면 같은 포털에 금융감독원 공시정보(공시검색) API도 있습니다. 특일 정보처럼 해마다 한 번 받아 두면 되는 자료는 구글 시트에 쌓아 두고 정해진 시각에 갱신하는 방법이 편합니다. 시트에서 정해진 시각에 스크립트를 돌리는 법은 구글 앱스 스크립트 사용법, 자동화 예시 5개에 있습니다.

개발계정과 운영계정은 무엇이 다른가요

활용 신청을 하면 먼저 개발계정으로 승인됩니다. 개발계정의 하루 호출량은 API마다 다릅니다. 상세 화면을 보면 특일 정보 · 단기예보 · 기업기본정보는 10,000, 국세청 상태조회는 1,000,000, 한 관광 빅데이터 API는 1,000으로 적혀 있습니다. 운영계정은 활용사례를 등록하고 신청하면 트래픽을 늘릴 수 있다고 안내합니다.

심의 방식도 API마다 다릅니다. 앞의 다섯 가지는 개발 · 운영 단계 모두 자동승인이지만, 운영단계가 심의승인으로 적힌 API도 있어 그때는 검토를 거칩니다. 호출량은 묶어서 아끼세요. 거래처 2,000곳의 상태를 한 곳씩 조회하면 하루 2,000번이지만, 국세청 API처럼 한 번에 100건을 받는 API라면 20번으로 끝납니다.

호출 오류는 어디부터 보나요

공공데이터포털 상세 화면의 오픈API 에러코드 안내에 공통 오류가 정리돼 있습니다. 그 가운데 처음 붙일 때 자주 보는 일곱 가지를 골랐습니다.

오류 메시지코드먼저 볼 곳
SERVICE_KEY_IS_NULL20요청에 인증키를 넣었는지
SERVICE_KEY_IS_NOT_REGISTERED_ERROR30키를 정확히 붙여 넣었는지, 그 API의 활용신청이 끝났는지
SERVICE_ACCESS_DENIED_ERROR20활용신청 승인 여부와 일시중지 상태
INVALID_REQUEST_PARAMETER_ERROR10파라미터 이름 · 형식 · 허용값(API 명세)
LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR22일일 호출 허용량 초과, 초기화 뒤 다시 호출하거나 트래픽 증설 신청
LIMITED_NUMBER_OF_SERVICE_REQUESTS_PER_SECOND_EXCEEDS_ERROR23짧은 시간에 몰린 요청, 간격을 두고 다시 호출
DEADLINE_HAS_EXPIRED_ERROR31인증키 사용 기한, 이용 기간 확인 · 갱신

키 오류가 나는데 키가 맞다면 주소 문자열에 키를 넣는 과정을 봅니다. 키에 들어 있는 기호가 두 번 인코딩되지 않도록 사용하는 라이브러리의 설정을 확인하세요. 호출량 오류는 대개 반복문 안에서 한 건씩 부르는 코드에서 나오므로, 묶음 조회가 되는 API인지 명세부터 다시 보세요.

자주 묻는 질문

공공데이터를 회사 서비스에 써도 되나요?

상세 화면의 이용허락범위를 보세요. 앞의 예시 가운데 국세청 상태조회 · 특일 정보 · 기업기본정보는 이용허락범위 제한 없음으로, 단기예보는 공공저작물 출처표시(제1유형)로 적혀 있습니다. 출처 표시 조건이면 결과를 보여 주는 화면에 제공 기관을 적습니다. 다섯 가지 모두 비용부과유무는 무료로 표시돼 있습니다.

크롤링 대신 공공데이터 API를 쓰면 무엇이 나은가요?

받는 형식이 명세로 정해져 있고 호출량 · 오류 코드가 공개돼 있어 운영 계획을 세우기 쉽습니다. 사이트 화면이 바뀌어도 영향을 받지 않습니다. 원하는 자료가 API로 열려 있지 않을 때만 수집 프로그램을 검토하고, 그때 정할 것은 크롤링, 웹 데이터를 모으는 프로그램을 만들 때 정할 것에 정리돼 있습니다.

구글 시트에서 API 결과를 바로 불러올 수 있나요?

앱스 스크립트의 URL 가져오기 기능으로 API를 호출해 결과를 시트에 적을 수 있습니다. 앱스 스크립트 안내는 URL 가져오기 호출을 개인 계정 하루 20,000번, Google Workspace 계정 하루 100,000번으로 제한하고 있어, 호출량은 API 쪽 한도와 함께 보세요.

공공데이터 API 연동을 외부에 맡기면 비용은 무엇으로 정해지나요?

붙일 API 수, 결과를 저장하고 화면에 보여 주는 범위, 정해진 시각 자동 실행과 실패 알림이 필요한지, 기존 거래처 · 주문 데이터와 맞추는 작업이 있는지로 정해집니다. 운영계정 전환에 필요한 활용사례 등록은 서비스 운영 쪽 이름으로 하는 것이 좋으니 역할을 미리 나눠 두세요. 공공데이터 API 연동 개발을 맡길 때는 앞의 업무 예시표처럼 업무별로 보내는 값과 받는 값을 적어 넘기면 견적이 빨라집니다.

오늘 할 일

공공데이터포털에 가입해 사업자등록정보 진위확인 및 상태조회 API를 활용 신청해 보세요.

이어서 읽기 — 노션 API, 내부 연결 5단계와 데이터베이스 자동 입력 예시

FacebookX

이 글과 맞는 서비스

이어서 읽기

블로그 전체 글 목록 →

카카오톡 상담식스원 고객센터 카카오톡 채널 (새 창)