본문 바로가기
AyoProject/Ayotera-Trade

Open DART (전자공시 API) 사용해보기

by 청양호박이 2020. 12. 16.

오늘은 DART에서 제공하는 전자공시 정보들을 web crawling을 통하지 않고, 수집하는 방법에 대해서 알아보겠습니다. 불과 몇년전부터 전자정부에 대한 단어가 나오기 시작하면서부터 많은 정부기관에서 제공하는 정보들을 표준 API를 통해서 사용을 할 수 있습니다.

 

대표적으로 [공공데이터 포털] www.data.go.kr/

 

공공데이터 포털

국가에서 보유하고 있는 다양한 데이터를『공공데이터의 제공 및 이용 활성화에 관한 법률(제11956호)』에 따라 개방하여 국민들이 보다 쉽고 용이하게 공유•활용할 수 있도록 공공데이터(Datase

www.data.go.kr

에서 많은 정보를 구할 수 있죠... 사용법도 은근 간단하고... 우리가 흔히 알고 있는 어플리케이션에서도 이런 공공데이터를 사용하여 구현되었습니다.

 

예를들어, 서울버스 시간표와 같은 어플들도 다 공공데이터를 통해서 받아와 서비스를 제공하는 것이고... 당장 최근에 코로나19 (COVID-19)때문에도 마스크 정보에 대해서 해당 공공데이터 API로 제공해 줬었습니다. 

 

그렇다면, 전자공시 정보는 어떻게 API로 구할 수 있을까요?? 너무 고민할 필요는 없습니다. 왜냐하면... 전자공시시스템(DART)에 들어가 보면 그 해결책을 얻을 수 있기 때문입니다.

 

 

1. OPEN DART (전자공시 API) 접속


전자공시시스템(DART)에 접속하면 아래와 같이 오른쪽 하단에 [오픈다트] 라는 아이콘을 찾을 수 있습니다. 

 

 

고민없이 누르게 되면 OPEN DART에 접속이 되고, 간단하게 살펴보면 오픈API의 소개, 인증키 신청/관리, 개발가이드 등등 많은 정보를 제공해 줍니다.

 

 

 

2. 인증키 신청


모든 공공데이터를 제공하는 API는 개인 인증키를 부여하고, 그 인증키를 사용해서 API를 통해 데이터를 받아오게 됩니다. 따라서 API사용의 시작이 되는 인증키를 신청해 보겠습니다.

 

제 경험상 OPEN DART의 인증키는 신청 후 이메일 인증만 수행하면 바로 발행이 됩니다.

 

별도의 회원가입없이, 사용자의 이메일과 신규 비밀번호... 마지막으로 용도만 입력하면 바로 등록이 진행되며, 입력한 이메일로 확인메일이 옵니다. 최종적으로는 확인메일에 확정만 하게되면 바로 인증키가 발급되어 사용이 가능합니다.

 

이제 인증키를 확인하러 가보겠습니다. 새로 만들어 봤는데... 역시나 바로 처리가 되네요...^ ^ 인증키 발급이 확인되었으면, 모든 준비가 완료되었습니다.

 

 

 

3. 개발가이드를 통해 API확인 하기 


이제 어떤 API가 있고, 어떻게 사용하는지 알아보겠습니다. 상단 메뉴에 보면 [개발가이드] 라는 메뉴탭이 있고, 클릭하면 제공하는 다양한 API에 대해서 확인 할 수 있습니다.

 

이번에는 모든 API에 대해서 알아보지는 않고, 관심가는 것 중에 하나만 살펴보겠습니다. 

 

[개발가이드] - [상장기업 재무정보] - [단일회사 전체 재무제표]를 선택해 보겠습니다.

 

 

API의 주소 및 필요한 요청인자에 대한 정보도 상세하게 제공합니다. 하단에  OpenAPI 테스트 메뉴도 제공하기 때문에 편리합니다. 그럼 테스트를 눌러볼까요??

	https://opendart.fss.or.kr/api/fnlttSinglAcntAll.json?
    crtfc_key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&
    corp_code=00126380&bsns_year=2018&reprt_code=11011&fs_div=OFS

위와 같은 URL로 요청이 됨을 확인 할 수 있습니다. 또한 그 결과는 아래 API결과 Textarea에서 확인할 수 있습니다. 

 

 

 

4. 인증키 및 이용현황 관리


마지막으로 인증키에 해당하는 일별 이용현황 관리에 대해서 알아보겠습니다. 정부에서 제공하는 API가 대부분 그런거 같은데... API제공 서버의 부하를 위해서 일별 호출이 가능한 건수를 제한합니다. OPEN DART에서는 일 최대 10,000건 까지 호출이 가능합니다.

 

이제 OPEN DART를 통해서 상장기업의 공시정보를 가져올 준비를 마쳤습니다. 

 

- Ayotera Lab -

댓글