아파트 실거래가 파워BI 분석(1): OPEN API 승인 받기

들어가며

공공데이터포털을 이용하면 손 쉽게 아파트 실거래가 정보를 이용할 수 있습니다. 하지만 공공데이터포털 OPEN API를 이용할려면 파이썬 등의 코딩이 필요합니다. 그러나 Power BI Desktop이 있으면 코딩없이 OPEN API를 호출 및 사용 할 수 있습니다. 하지만 좀처럼 Power BI Desktop 파워BI로 공공데이터포털 아파트 실거래가 OPEN API를 호출하고 분석하는 방법에 대한 문서를 잘 찾아볼 수 없습니다. 따라서 Power BI로 공공데이터포털 아파트 실거래가 OPEN API 호출 및 분석 방법에 대해서 알아보는 포스팅을 기획하게 되었습니다. 본 포스팅 시리즈를 잘 숙지하면 아파트 실거래가 OPEN API 뿐 만 아니라 공공데이터포털의 다른 Data OPEN API들도 쉽게 응용하여 사용할 수 있게 될 것 입니다.

아직 이전 포스팅을 읽지 않으신 분들은 아래를 참고하시기 바랍니다.

Power BI Desktop 다운로드 및 설치 2가지 방법

공공데이터포털 가입 및 로그인

아래는 공공데이터포털 바로가기 입니다.

https://www.data.go.kr/

저의 경우 기존 사용하고 있는 아이디가 별도로 있지만, 본 블로그 포스팅을 위해서 카카오 계정으로 로그인을 하였습니다.

공공데이터포털실거래가OPEN-API사용신청방법01
공공데이터포털실거래가OPEN-API사용신청방법01

이렇게 요즘 플랫폼이나 웹,앱들은 대체적으로 소셜 로그인을 많이 사용하고 있는 편입니다.

소셜 로그인이란, 인터넷에서 다양한 서비스나 앱을 사용할 때마다 새로운 아이디와 비밀번호를 만들지 않고, 이미 가지고 있는 소셜 미디어(예: 페이스북, 구글, 네이버, 카카오 같은) 계정을 사용해서 로그인하는 방법을 말합니다.

로그인에 성공하면 아래 처럼 본인인증 정보수집 팝업이 열리는데, 굳이 원하지 않는다면 닫으면 됩니다. 하지만 로그인 할 때 마다 본 팝업은 계속해서 뜨게 될 것 입니다.

공공데이터포털실거래가OPEN-API사용신청방법02
공공데이터포털실거래가OPEN-API사용신청방법02

실거래가 OPEN API 검색하기

이제 공공데이터포털에 로그인을 하였으므로, <실거래가>라고 검색해 보도록 하겠습니다.

공공데이터포털실거래가OPEN-API사용신청방법03
공공데이터포털실거래가OPEN-API사용신청방법03

현재 공공데이터포털에서는 실거래가에 대해서 총 43건이 검색되었고, 그 중에서 20개의 오픈API가 있다고 나오는 것을 볼 수 있습니다.

아래 이미지 처럼 오픈API 탭 메뉴를 클릭합니다.

공공데이터포털실거래가OPEN-API사용신청방법04
공공데이터포털실거래가OPEN-API사용신청방법04

그 중에서도 우리가 신청 후 사용해야 할 OPEN API는 아래 붉은 박스에 있는 2개의 오픈API입니다.

공공데이터포털실거래가OPEN-API사용신청방법05
공공데이터포털실거래가OPEN-API사용신청방법05

아파트 매매,전월세 OPEN API는 다음과 같습니다.

국토교통부_아파트매매 실거래자료

https://www.data.go.kr/data/15058747/openapi.do

국토교통부_아파트 전월세 자료

https://www.data.go.kr/data/15058017/openapi.do

먼저 국토교통부_아파트매매 실거래자료 사용신청을 위해서 활용신청 버튼을 클릭합니다.

OPEN API 개발계정 신청하기

그러면 OpenAPI 개발계정 신청 페이지로 넘어가게 됩니다.

자동승인: 신청하면 자동으로 승인된다는 뜻(하지만 공휴일에는 지연이 되네요. 글을 적고 있는 이 순간 일요일인데, 아직 승인되지 않았어요. 원칙은 몇 일 걸린다고 합니다. 참고하세요.)

개발계정: 개발계정 외에 운영계정이 있어요. 개발계정 신청이라는 뜻

승인일로부터 24개월 간 활용가능: 한 번 사용신청 시 2년 동안 사용할 수 있음.

공공데이터포털실거래가OPEN-API사용신청방법06
공공데이터포털실거래가OPEN-API사용신청방법06

이어서 활용목적에 아래 처럼 체크하고 작성하시면 될 것 같습니다. 그리고 이용목적범위에 동의합니다 에 체크를 합니다.

공공데이터포털실거래가OPEN-API사용신청방법07
공공데이터포털실거래가OPEN-API사용신청방법07

그런 다음 활용신청 하면 아래와 같이 신청하겠습니까? 라는 경고창이 뜹니다. 당연히 확인 클릭~!!

공공데이터포털실거래가OPEN-API사용신청방법08
공공데이터포털실거래가OPEN-API사용신청방법08

그러면 이번엔 신청이 완료되었다는 경고창으로 답을해주는 친철한 공공데이터포털 사이트 입니다.

공공데이터포털실거래가OPEN-API사용신청방법09
공공데이터포털실거래가OPEN-API사용신청방법09

실거래가 OPEN API 호출하기

이렇게 활용신청을 하고난 뒤 마이페이지>API신청 으로 들어 가보면 조금 전 신청했던 국토교통부_아파트매매 실거래자료 목록을 볼 수 있습니다.

공공데이터포털실거래가OPEN-API사용신청방법10
공공데이터포털실거래가OPEN-API사용신청방법10

현재는 활용 1건 이라고 나오는 것을 볼 수 있습니다.

공공데이터포털실거래가OPEN-API사용신청방법11
공공데이터포털실거래가OPEN-API사용신청방법11

활용신청 상세기능정보 중 일일트래픽 1000 항목을 볼 수 있습니다. 바로 이 부분이 현재 개발계정 이지만, 앞으로 운영계정으로 업그레이드가 필요한 이유가 됩니다.

공공데이터포털실거래가OPEN-API사용신청방법12
공공데이터포털실거래가OPEN-API사용신청방법12

위에서 ②확인 버튼을 클릭하면, 아래 처럼 요청변수 라는 항목이 나타나게 됩니다.

공공데이터포털실거래가OPEN-API사용신청방법13
공공데이터포털실거래가OPEN-API사용신청방법13

저 같은 경우 아래 처럼 아직 승인이 되지 않았다는 메세지가 나오는것을 볼 수 있습니다.

<response>
 <script/>
 <header>
  <resultCode>99</resultCode>
  <resultMsg>SERVICE KEY IS NOT REGISTERED ERROR.</resultMsg>
 </header>
</response>
공공데이터포털실거래가OPEN-API사용신청방법14
공공데이터포털실거래가OPEN-API사용신청방법14

제대로 사용신청 승인이 나면, 아래와 같이 아파트 매매 실거래가 정보들이 나오는 것을 볼 수 있을것 입니다.

공공데이터포털실거래가OPEN-API사용신청방법17
공공데이터포털실거래가OPEN-API사용신청방법17

OPEN API 개발계정 일일 트래픽 한계

여기서 잠깐 개발계정에서 바로 운영계정으로 활용신청 해야 하는 이유에 대해서 말씀드리도록 하겠습니다.

공공데이터포털실거래가OPEN-API사용신청방법12
공공데이터포털실거래가OPEN-API사용신청방법12

일일트래픽이란? 하루 24시간 동안 요청할 수 있는 숫자를 말하는데, 1000이라고 하면 1000번을 요청할 수 있다는 뜻 입니다.

아파트매매 실거래가 정보를 요청할 경우, 두 개의 요청변수가 필요합니다.

①LAWD_CD: 각 지역별 코드 (경상남도 진주시: 48170)

②DEAL_YMD: 월 단위 신고자료 (2024년2월 자료: 202402)

경상남도 진주시의 2024년 02월 아파트 매매 실거래가 자료를 볼려면 위 처럼 요청변수를 입력하면 되겠습니다.

공공데이터포털실거래가OPEN-API사용신청방법13
공공데이터포털실거래가OPEN-API사용신청방법13

아파트매매 실거래가 자료는 2006년 01월 부터 시작되었습니다. 따라서 경상남도 진주시의 아파트 매매 실거래가 자료를 모두 구할려면 2006년 01월 부터 현재 2024년 02월 까지의 총 218개의 DEAL_YMD 변수가 필요합니다. 여기서 대략 진주시 말고 다른 시군구 4개의 아파트 매매 실거래가 자료를 구할려고 한다면 총 218*5= 1090으로 일일트래픽 1000이 초과해버리게 됩니다.

결국 개발계정으로는 하루 24시간 동안 4개 시군구의 아파트 매매 실거래가 자료만 전부 받을 수 있을 뿐 더 이상 다른 시군구의 자료를 구할 수 없게 됩니다. 만 24시간이 지나야 다시 1000개의 트래픽을 사용할 수 있으므로 만약 분석이 더 필요한 경우에는 하루 24시간이 지나야 가능한 것을 알 수 있습니다.

위 같은 사실이 바로 개발계정에서 운영계정으로 꼭 업그레이드 해야 하는 이유입니다.

실거래가 OPEN API 운영계정 신청하기 TIP

운영계정 신청을 위해서 아래 처럼 운영계정 신청 버튼을 클릭합니다.

공공데이터포털실거래가OPEN-API사용신청방법15
공공데이터포털실거래가OPEN-API사용신청방법15

일일 트래픽이 100만 이나 되는 것을 확인할 수 있습니다. 이는 하루에 전국 매매실거래가 정보를 전부 호출하고도 남을 양 입니다.

기능 및 서비스 화면 설명에는 “실거래가를 파워BI로 차트 또는 시각화하여 분석하는 프로그램” 이런 느낌으로 기재하시면 되겠습니다.

기능 및 서비스 화면/ 대표 이미지(썸네일) 항목에는 이미지를 첨부해야 합니다. 이미지는 아래 블로그 포스팅 중 아무 Power BI로 구현한 차트를 첨부하시면 됩니다.

부동산빅데이터땅짚고-네이버블로그

https://blog.naver.com/rmawn0504

위 블로그에서 ‘Power BI‘ 또는 ‘파워BI‘ 이렇게 검색한 다음, 포스팅 내부의 차트 및 시각화 이미지가 있으면 그것을 다운로드 받아서 첨부하시면 되겠습니다. 아래 몇 몇 예시 포스팅들 입니다.

https://blog.naver.com/rmawn0504/223356257777

https://blog.naver.com/rmawn0504/222649631095

https://blog.naver.com/rmawn0504/221284655667

https://blog.naver.com/rmawn0504/223155732266

https://blog.naver.com/rmawn0504/223185719274

서비스 개시일(론칭일) 의 경우 미래의 특정 날짜를 기재하시면 될 것 입니다.(사후 체크하지 않으므로 편하게 기재하세요^^)

그 외 사항은 여러분 상황에 맞도록 작성하시면 되겠습니다.

공공데이터포털실거래가OPEN-API사용신청방법16
공공데이터포털실거래가OPEN-API사용신청방법16

마치며

이렇게 해서 공공데이터포털 아파트 실거래가 OPEN API 개발계정 신청에서 운영계정 신청 까지 모두 살펴보았습니다. 이 후 포스팅 부터는 본격적으로 이제 Power BI에 OPEN API를 호출하여 분석하는 방법에 대해서 상세하게 풀어나가 보도록 하겠습니다. 많이 기대해 주시기 바라며, 본 포스팅이 유익하셨다면 많은 분들에게 공유해주시면 더 좋은 포스팅으로 다시 찾아뵙도록 하겠습니다.

이상 저는 부를 코딩하는 코딩맨 지중해부자 였습니다.

댓글 남기기

Leave a Comment