공공데이터(data.go.kr) 포털 이용하기 - 국토교통부 실거래가

2018-11-23

국가에서 제공하고 있는 공공데이터를 이용해보는 방법을 알아보겠습니다.

data.go.kr 접속

INFO
API 사용 신청을 하기 위해서는 익스플로러를 사용해야합니다. (크롬안됨)
API 사용 신청을 하기 위해서는 가입이 되어있어야 합니다. 가입절차는 간단하므로 미리 가입해두세요

https://data.go.kr 를 접속해보면 아래와 같은 화면이 나옵니다.

data.go.kr

화면 상단의 메뉴에서 ‘데이터셋’ - Open API 를 들어가면 ‘오픈 API 3,033건을 찾았습니다.’ 라는 문구와 함께 검색 결과가 표시됩니다.
국가에서 제공하는 데이터(API)가 3000건이 넘는 것을 알 수 있습니다.
네, 실제로 굉장히 많이 제공하고 있습니다.

이 포스트에서는 국토교통부에서 제공하는 실거래가 API를 사용해보겠습니다.

검색창에 ‘실거래가’ 를 입력해보면 4개의 검색 결과가 표시됩니다.

실거래가

이 중 ‘국토교통부 실거래가 정보’ 를 클릭해 들어가봅니다.

API 명세서 확인

들어가보니 다시 여러개의 데이터가 제공되는 것이 보입니다.
상업업무용 부동산 매매 신고 자료, 아파트 분양권전매 신고 자료, 아파트매매 실거래자료, 연릭다세대 매매 실거래자료, …
여기서 제가 관심있는 자료는 아파트매매 실거래자료입니다.

아파트매매 실거래자료의 상세정보를 눌러보면 아래처럼 데이터가 무료로 제공되며, 이용범위도 제한이 없음이 확인됩니다.

아파트매매 실거래자료 상세정보

참고문서를 열어보면 API 이용방법을 알 수 있습니다.

INFO
국가에서 운영하는 사이트답게?! 모든 문서는 HWP로 제공되고 있습니다.
한컴오피스가 깔려있다면 문제없이 열람이 가능하지만, 그렇지 않다면 한컴오피스 뷰어를 설치하는 것도 고통스러운 작업입니다.
네이버 아이디가 있으시다면 네이버 오피스를 이용해서 hwp파일을 열 수 있습니다. (저 네이버 직원 아닙니다)
https://office.naver.com 에서 확인해보세요

내용을 열어보면 URL에 따라 아파트 실거래자료, 연립대세대 매매 실거래자료, 단독다가구 매매 실거래자료 등 총 10가지 분류의 자료를 제공하는 것을 볼 수 있습니다.

아파트 매매 신고정보 조회 서비스를 살펴보면 지역코드, 계약월을 요청값으로 주면 결과값으로 법정동, 아파트, 매매일, 전용면적 등의 정보를 제공하는 것을 볼 수 있습니다.

아파트매매 실거래자료 요청 값

아파트매매 실거래자료 결과

INFO
요청값으로 넘기는 값에서 지역코드라는 값이 있습니다.
Q&A에서 검색해서 알게되었는데, 여기서 넘겨야 하는 지역코드는 법정동코드 5자리입니다.
지역 별 법정동 코드는 https://www.code.go.kr/stdcode/regCodeL.do에서 확인이 가능합니다.

추가: 실거래가 API에서 사용가능한 모든 법정동코드를 포스팅하였습니다.

API 사용 신청

API를 사용하기에 앞서, 요청으로 넘겨야하는 값에 service key값이 필요합니다.
service key값은 API 활용신청을 통해 얻을 수 있습니다.

API 안내 페이지에서 상세정보 버튼 옆에 활용신청버튼을 클릭합니다.

API 활용 신청

시스템유형, 활용정보, 상세기능정보 등을 입력하는 란이 나옵니다.
적당히 채우고 신청버튼을 누릅니다.

아파트매매 실거래자료는 자동승인 서비스이기 때문에 곧바로 승인이 됩니다.
승인이 되면 화면 상단의 마이페이지 > 오픈API > 운영계정에 ‘승인’항목으로 리스트에 표시됩니다.

리스트 항목을 클릭하여 들어가면 인증키를 볼 수 있습니다.

INFO
인증키가 나오지 않으면 조금 기다렸다가 다시 들어가보세요
인증키가 나왔더라도 바로 사용가능하지 않습니다. 체감상 인증키 발급 후 10분~60분정도 이후부터 사용 가능했던 것 같습니다.

API 사용

인증키를 발급받았으니 API 를 사용해보겠습니다.

요청 endpoint 주소는 아래와 같았습니다.

http://openapi.molit.go.kr:8081/OpenAPI_ToolInstallPackage/service/rest/RTMSOBJSvc/getRTMSDataSvcAptTrade

요청에 필요한 parameter는 serviceKey와 지역코드(LAWD_CD), 거래월(DEAL_YMD) 였습니다.
각 내용을 parameter로 만들어 넣어봅니다.

INFO
서울시 서초구 반포동의 법정동코드는 1165000000 입니다. 이중 앞의 5자리를 잘라서(11650) 사용합니다.
DEAL_YMD는 테스트해보니 2006년부터 자료가 있는 것으로 확인됩니다. 이전자료는 없는 것 같습니다.

http://openapi.molit.go.kr:8081/OpenAPI_ToolInstallPackage/service/rest/RTMSOBJSvc/getRTMSDataSvcAptTrade?serviceKey=발급받은서비스키&LAWD_CD=11650&DEAL_YMD=201810

URL 을 브라우저에 넣어봅니다.

API result

결과 XML이 잘 넘어오는 것을 확인할 수 있습니다.

결론

지금까지 공공 데이터포털에서 OpenAPI를 이용하여 아파트매매 실거래가 정보를 받아오는 방법을 알아보았습니다.

사용방법이 간단하고, 제공해주는 data도 잘 정리되서 응답을 주는 것으로 확인됩니다.
이런 양질의 데이터를 제공하는 것에 감사하고, 이러한 데이터(API)를 많은 서비스가 생길 수 있을 것으로 기대합니다.

NOTE
실거래가 데이터를 기반으로 한 지역별 아파트 랭킹 사이트도 참고해보세요
지역 별 아파트 가격 순위