한국은행의 경제통계시스템(ECOS)의 open api를 이용해 10년간의 주요 지표를 추출하는 법을 알아 보겠습니다.
api는 application program interface로 라이브러리에 접근하기 위한 규칙들을 정의 한 것입니다. 그래서 인증키와 그 구성요소를 이해한다면 누구나 손쉽게 데이터를 처리할 수 있습니다.
일단 아래의 링크를 통해 사이트 접속하신 다음 인증키를 발급해 주시면 됩니다.
인증키는 유저가 라이브러리에서 정보를 추출할 수 있는 권한을 부여합니다.
인증키를 발급받으셨다면 my page에서 확인하실 수 있습니다.
한은 ecos에서는 제공하는 서비스는 총6 가지로 내용은 아래와 같습니다.
서비스 명 | 내용 |
---|---|
100대 통계지표 | 한국은행 및 타기관에서 작성한 통계지표 중 정책수립 및 동향분석에 유용한 통계지표 100개를 선정하여 제공합니다. |
서비스통계목록 | OpenAPI 대상 통계목록을 제공합니다. |
통계세부항목 목록 | 서비스대상 통계의 세부 통계항목을 보여줍니다. |
통계조회조건설정 | 데이터 이용을 위한 조회조건 설정방법(통계코드, 통계명, 세부항목명, 기간 등)을 제공합니다. |
통계메타DB | 한국은행에서 작성, 제공하는 15개 통계에 대한 이용자의 이해를 돕기 위한 통계 설명자료입니다. |
통계용어사전 | 경제 및 통계에 대한 전문용어를 알기쉽게 풀이한 사전으로서 가나다순 으로 정리한 총 803개의 용어를 설명하고 있습니다. |
저는 4대 통계 지표인 gdp 성장률, m2 평잔, 경상수지, 물가지수(cpi, ppi)를 추출하여 시각화할 예정이기 때문에 통계조회조건설정 서비스를 이용할 것입니다.
자세한 설명은 개발명세서의 각 서비스 항목마다 존재합니다. 이는 아래의 링크를 확인하시면 됩니다.
개발명세서
개발명세서를 살펴보시면 상세구조와 요청인자로 나눠 있습니다. 상세구조와 요청인자의 조합으로 url을 형성하여 데이터를 추출합니다.
상세주소와 요청인자는 다음과 같습니다.
-상세주소: http://ecos.bok.or.kr/api
-요청인자:
이를 조합하면 다음과 같은 형태의 url을 완성시킬 수 있습니다.
url=
http://ecos.bok.or.kr/api/서비스명/인증키/요청타입/언어/요청시작건수/오쳥종료건수/통게코드/주기/검색시작일자/검색종료일자/항목코드
순으로 조합할 수 있습니다. 이는 샘플테스트를 통해 확인 하실 수있습니다. 저는 2019의 분기별 gdp 성장률을 알고 싶습니다. 그렇다면 위 요청인자들은 다음과 같이 입력하시면 됩니다.
통계코드와 항목코드는 다음의 링크를 통해 확인 하실 수 있습니다.
OpenAPI 서비스
이제 준비과정은 다 끝났습니다. 다음 포스팅을 통해 실제로 데이터를 추출하는 코드를 배워보도록 하겠습니다.