질병관리청 API, 데이터로 우리 동네 건강을 지키는 방법
2020년 초, 매일 아침 눈을 뜨자마자 스마트폰으로 코로나19 확진자 수를 확인하며 우리를 짓누르던 그 막막함, 혹시 아직도 생생하게 기억하고 계신가요? 저 역시 하루에도 몇 번씩 관련 뉴스를 새로고침하며 불안감에 휩싸여 마음을 졸이곤 했지요. 그때 우후죽순처럼 생겨났던 실시간 확진자 현황 지도나 동선 알림 앱들을 보며 ‘이런 데이터는 대체 어디서 오는 걸까?’ 하는 궁금증이 문득 솟아오르더군요. 그 궁금증의 핵심에 바로 오늘 우리가 알아볼 질병관리청 API가 존재했습니다. 이 강력한 도구는 단순히 숫자를 나열하는 차원을 넘어, 개발자와 연구자들은 물론 평범한 시민인 우리 모두에게 공중 보건 데이터라는 소중한 창을 활짝 열어주며, 궁극적으로는 더 건강하고 안전한 사회를 만드는 데 커다란 힘이 되고 있습니다.
질병관리청 API란? 공중 보건 데이터의 문을 열다
질병관리청 API를 아주 쉽게 비유하자면, 마치 ‘공중 보건 데이터 레스토랑의 공식 메뉴판’과 같습니다. 우리가 레스토랑에서 메뉴판을 보고 원하는 음식을 주문하면 웨이터가 주방에서 음식을 가져다주듯, 개발자들은 이 ‘메뉴판(API 명세서)’을 보고 원하는 데이터를 ‘주문(요청)’하면, 질병관리청 서버가 알아서 최신 데이터를 ‘서빙(응답)’해주는 방식인 셈입니다.
API(Application Programming Interface)는 다음과 같은 역할을 합니다.
프로그램들이 서로 소통하고 정보를 주고받기 위한 미리 정해놓은 약속된 규칙입니다.
복잡한 질병관리청 데이터베이스에 직접 접속할 필요 없이, 약속된 통로를 활용해 감염병 발생 현황, 예방접종 통계, 건강검진 정보 등 국가의 핵심 보건 데이터를 자신의 앱이나 웹 서비스, 연구 분석 시스템에 손쉽게 연동할 수 있게 합니다.
현재 공공데이터포털(data.go.kr)에서는 30종이 넘는 다양한 API가 무료로 제공되고 있습니다. 이는 국민과의 소통을 강화하고 데이터 기반의 과학적 방역을 실현하려는 노력의 일환으로, 2020년 9월 질병관리본부가 질병관리청으로 승격되면서 데이터 개방이 더욱 활발해진 결과입니다. 이처럼 투명한 데이터 공개는 행정에 대한 국민의 신뢰를 쌓는 데 기여합니다.

어떤 데이터를 얻을 수 있나요? 감염병부터 만성질환까지
코로나19 팬데믹 시절, 우리가 매일같이 확인했던 실시간 확진자 현황판 서비스들이 바로 이 API 데이터를 기반으로 만들어졌던 가장 대표적인 사례였지요. 이 질병관리청 API가 제공하는 데이터의 범위는 놀라울 정도로 넓고 구체적입니다.
감염병 데이터: 코로나19를 비롯해 인플루엔자(독감) 감시 정보, 수족구병, 결핵 등 다양한 법정 감염병의 주간, 월간 발생 현황을 지역별, 연령별로 상세하게 확인할 수 있습니다.
예방접종 통계: 국가 필수 예방접종 항목별 접종률, 연령별 접종 현황 등 백신과 관련된 중요한 통계 데이터가 제공됩니다.
국민건강 통계: 국민건강영양조사를 바탕으로 한 고혈압, 당뇨병 등 만성질환 유병률은 물론, 흡연율, 음주율, 비만율 등 우리 국민의 건강 상태를 다각도로 면밀히 파악할 수 있는 데이터가 풍성하게 담겨 있습니다.
의료기관 정보: 전국 응급의료기관의 위치, 실시간 병상 정보 등 위급 상황에서 꼭 필요한 정보들도 API를 통해 파악할 수 있습니다.
이 모든 데이터는 개발자들이 다루기 쉬운 표준 형식인 JSON이나 XML로 제공되어 데이터를 시각화하거나 지도에 표시하는 등의 작업을 훨씬 수월하게 진행할 수 있습니다.

초보 개발자도 OK! API 사용법 A to Z
“코딩을 잘 몰라도 사용할 수 있을까?” 걱정할 필요 없습니다. 초보 개발자도 충분히 도전해볼 만합니다. 질병관리청 API가 매우 체계적이고 표준화된 절차를 따르기 때문이지요.
> 제가 처음 제 개인 프로젝트였던 ‘우리동네 건강 신호등’ 앱을 만들던 2021년 여름이 생각나네요. 그때 저도 공공데이터 API는 처음이었지만, 생각보다 과정이 간단해서 놀라웠던 기억이 선명하네요. 어렵지 않으니, 지금 바로 시작해보세요.
API 활용의 기본적인 단계는 다음과 같습니다.
| 단계 | 내용 |
|---|---|
| 1. 회원가입 | 데이터의 통합 창구인 공공데이터포털(data.go.kr)에 가입해야 합니다. |
| 2. 키 발급 | 포털에서 ‘질병관리청’을 검색해 원하는 API 서비스를 찾아 ‘활용 신청’ 버튼을 누르세요. 간단한 정보만 입력하면 거의 즉시 ‘API 키(서비스 키)’라는 긴 문자열을 발급받을 수 있습니다. 이 키는 나를 식별하는 일종의 비밀번호 같은 역할을 하므로, 데이터를 요청할 때마다 반드시 포함해야 합니다. |
| 3. 데이터 확인 | 각 API의 상세 설명 페이지에서는 어떤 주소로, 어떤 정보(파라미터)를 담아 요청해야 하는지 아주 친절하게 안내하고 있으므로, 안내에 따라 API 키를 포함한 요청 주소를 만들어 인터넷 브라우저 주소창에 붙여넣기만 해도 데이터가 화면에 나타나는 것을 곧바로 확인할 수 있습니다. |
물론 안정적인 서버 운영을 위해 서비스별로 하루에 데이터를 요청할 수 있는 횟수(보통 1,000~10,000회)가 정해져 있습니다. 이는 공공의 자원을 책임감 있게 사용해야 한다는 점과 함께 안정적인 서버 운영을 위한 조치인 만큼, 만약 더 많은 요청이 필요하다면 별도 승인을 요청할 수 있으니 잘 활용해 보시길 바랍니다. 제공되는 예제 코드를 그대로 따라 해보는 것이 가장 빠른 학습 방법 중 하나입니다.

믿고 써도 될까? 데이터의 신뢰도와 개인정보보호
공공 데이터를 사용할 때 가장 중요한 두 가지는 바로 ‘데이터의 신뢰도’와 ‘개인정보보호’입니다. 질병관리청 API는 이 두 가지 원칙을 철저히 지키고 있어 안심하고 활용할 수 있습니다.
| 구분 | 설명 |
|---|---|
| 개인정보보호 | API를 통해 제공되는 모든 데이터는 개인을 식별할 수 있는 이름, 주민등록번호 등의 정보가 완벽하게 제거된 ‘비식별 통계 데이터’로 개인정보보호법을 엄격히 준수하고 있습니다. 특정인의 진료 기록이나 예방접종 내역이 유출될 걱정은 전혀 하지 않으셔도 됩니다. |
| 데이터 신뢰도 | 데이터의 신뢰도 역시 국가기관이 직접 관리하는 만큼 높은 수준을 유지하며, 사용자는 언제나 최신 정보를 바탕으로 서비스를 개발하거나 연구를 진행할 수 있습니다. 각 API의 상세 설명 페이지에 데이터의 출처와 업데이트 주기가 명확히 명시되어 있습니다. |
감염병 발생 현황처럼 시시각각 변하는 데이터는 매일 업데이트되고, 국민건강영양조사와 같은 대규모 통계는 분기별 또는 연도별로 정기적인 갱신 정책을 따릅니다.

누가 어떻게 활용하고 있을까? 실제 활용 사례와 현황
그렇다면 말입니다, 이 유용한 API를 실제로 누가, 어떻게 사용하고 있을까요? 2023년 통계에 따르면 월평균 호출 건수가 놀라운 150만 건에 달했습니다. 이처럼 활발하게 이용되는 배경에는 여러 주체가 API를 적극적으로 활용하고 있다는 점이 있습니다.
| 활용 주체 | 활용 비율 | 주요 활용 분야 |
|---|---|---|
| 의료기관 | 35% | 진료 지원, 병원 운영 데이터 분석 |
| 연구기관 | 28% | 학술 및 정책 연구 |
| 민간 헬스케어 기업 | 22% | 건강관리 앱, 새로운 서비스 개발 |
| 지방자치단체 | 15% | 지역 보건 정책 수립 |
질병관리청 API는 단순히 데이터를 창고에 쌓아두는 것을 넘어, 사회 각 분야에서 새로운 가치를 만들어내는 핵심 인프라로 확고히 자리 잡았습니다. 저처럼 개인 개발자가 만든 작은 프로젝트부터, 대형 병원의 분석 시스템에 이르기까지 그 활용 범위가 매우 넓습니다. 나아가 앞으로 더 많은 스타트업들이 이 데이터를 활용해 창의적이고 혁신적인 건강관리 서비스를 만들어주길 기대합니다.

미래를 향한 발걸음: 질병관리청 API의 잠재력
정부, 의료계, 산업계, 그리고 우리 국민 모두가 힘을 합쳐 더 건강한 사회를 만들 수 있는 튼튼한 기반이 마련된 것입니다. 질병관리청 API는 투명하게 공개된 데이터를 제공하며 데이터 기반의 과학적 방역 체계를 구축하고, 국민의 알 권리를 보장하며, 관련 산업 생태계를 키우는 데 핵심적인 역할을 수행해 왔습니다. 저는 이 API가 앞으로 우리 사회를 더 건강하게 만드는 핵심 도구가 될 것이라고 믿습니다. 그 잠재력은 무한합니다! 나아가 앞으로 더 다양하고 폭넓은 종류의 데이터가 추가되고, 국제 표준과의 호환성까지 높아진다면, 질병관리청 API는 대한민국을 넘어 세계적인 공중 보건 데이터 허브로 성장할 잠재력을 충분히 지녔습니다.
—

자주 묻는 질문 (FAQ)
Q1: 질병관리청 API가 정확히 뭔가요? 이걸로 뭘 할 수 있어요?
A1: 쉽게 말해, 질병관리청이 가진 공중 보건 데이터를 다른 프로그램이나 앱에서 가져다 쓸 수 있도록 만든 공식 ‘데이터 통로’를 의미해요. 이걸 이용하면 감염병 통계, 예방접종 현황, 국민 건강검진 결과, 응급실 정보 등 아주 다양한 데이터를 받아와서 실시간 건강 지도를 만들거나, 연구 분석에 활용하는 등 무궁무진한 일이 가능한 셈이지요.
Q2: 질병관리청 API를 사용하려면 돈을 내야 하나요? 어떻게 시작하죠?
A2: 아니요, 공공 데이터 활용을 장려하기 위한 것이라 전부 무료이니 걱정하지 마세요. 시작하는 방법은 간단합니다. 공공데이터포털(data.go.kr)에 회원가입 후, 쓰고 싶은 API를 찾아 ‘활용 신청’만 하면 바로 사용할 수 있는 ‘서비스 키’를 발급받을 수 있습니다.
Q3: API를 하루에 몇 번이고 계속 호출해도 되나요? 제한은 없나요?
A3: 제한이 있답니다. 안정적인 서비스 운영을 위해 API마다 하루에 호출할 수 있는 횟수(일일 트래픽)가 정해져 있어요. 보통 1,000회에서 10,000회 정도인데, 개인적인 프로젝트나 연구에는 충분한 수준이라고 볼 수 있어요. 만약 아주 큰 서비스를 만들어 더 많은 호출이 필요하다면 별도 심사를 통해 상향 조정할 수 있습니다.
Q4: 이걸로 제 예방접종 기록이나 친구의 진료 기록을 볼 수 있나요?
A4: 아니요, 절대 불가능합니다. 질병관리청 API는 개인정보보호법에 따라 이름, 연락처 등 개인을 알아볼 수 있는 정보는 모두 제거하고, ‘서울시 20대 남성 흡연율’처럼 통계적으로 처리된 데이터만 제공하는 바입니다. 개인정보는 철저히 보호되니 안심하셔도 됩니다.
Q5: API로 받은 데이터는 믿을 만한가요? 얼마나 최신 정보예요?
A5: 네, 대한민국 질병관리청이 직접 생산하고 관리하는 공식 데이터이므로 신뢰도는 매우 높은 수준을 자랑합니다. 감염병 발생 현황처럼 시급한 정보는 매일 업데이트되고, 건강 통계 같은 데이터도 분기별, 연도별로 꾸준히 갱신되고 있답니다. 각 API의 상세 설명 페이지에서 정확한 업데이트 주기를 직접 확인할 수 있더군요.

안녕하세요, 20년째 글로벌 API의 표준을 연구하는 조민희입니다. 😉
다양한 API와 실무 연동 사례에 대해 소개해드려요.
복잡한 기술도 원리만 알면 쉽습니다. 저와 함께 가장 빠르고 정확한 연동 방법을 찾아봐요! 🚀