- 기획/개발/관리: 정우일(Wooil Jeong)
- e-mail: wooil@kakao.com
- 사용 설명서: PublicDataReader - 부동산 데이터 수집하기
- 코랩 실습 코드: Colab
-
최신 버전
-
요구 사항
PublicDataReader는 공공데이터포털에서 제공하는 OpenAPI 서비스를 Python으로 쉽게 이용할 수 있도록 도와주는 데이터 수집 라이브러리입니다. 2020년 04월 현재 국토교통부 실거래가 정보 조회 서비스에 대한 인터페이스를 제공하고 있습니다. 추후 수요가 높은 Open API 서비스에 대한 인터페이스도 지속적으로 업데이트할 예정입니다.
| 기능 | 서비스 명 |
|---|---|
| pdr.AptTradeReader | 아파트매매 실거래자료 조회 |
| pdr.AptTradeDetailReader | 아파트매매 실거래 상세 자료 조회 |
| pdr.AptRentReader | 아파트 전월세 자료 조회 |
| pdr.AptOwnershipReader | 아파트 분양권 전매 신고 자료 조회 |
| pdr.OffiTradeReader | 오피스텔 매매 신고 조회 |
| pdr.OffiRentReader | 오피스텔 전월세 신고 조회 |
| pdr.RHTradeReader | 연립다세대 매매 실거래자료 조회 |
| pdr.RHRentReader | 연립다세대 전월세 실거래자료 조회 |
| pdr.DHTradeReader | 단독/다가구 매매 실거래 조회 |
| pdr.DHRentReader | 단독/다가구 전월세 자료 조회 |
| pdr.LandTradeReader | 토지 매매 신고 조회 |
| pdr.BizTradeReader | 상업업무용 부동산 매매 신고 자료 조회 |
pip install PublicDataReader# 1. 라이브러리 임포트 및 버전 확인하기
import PublicDataReader as pdr
print(pdr.__version__)
# 2. 공공 데이터 포털 Open API 서비스 인증키 입력하기
serviceKey = "<<YOUR API SERVICE KEY>>"
# 3. 사용할 서비스의 인스턴스 생성하기
AptTrade = pdr.AptTradeReader(serviceKey)
AptTradeDetail = pdr.AptTradeDetailReader(serviceKey)
AptRent = pdr.AptRentReader(serviceKey)
AptOwnership = pdr.AptOwnershipReader(serviceKey)
OffiTrade = pdr.OffiTradeReader(serviceKey)
OffiRent = pdr.OffiRentReader(serviceKey)
RHTrade = pdr.RHTradeReader(serviceKey)
RHRent = pdr.RHRentReader(serviceKey)
DHTrade = pdr.DHTradeReader(serviceKey)
DHRent = pdr.DHRentReader(serviceKey)
LandTrade = pdr.LandTradeReader(serviceKey)
BizTrade = pdr.BizTradeReader(serviceKey)
# 4. 지역코드 검색하기
df_code = AptTrade.CodeFinder("백현동") # 지역코드 : 41135
df_code.head()
# 5. 지역, 월 별 데이터 프레임 만들기
# Function("지역코드 5자리", "계약월(YYYYMM)")
# 2020년 03월 백현동에 해당하는 자료를 Pandas DataFrame 으로 생성
df_AptTrade = AptTrade.DataReader("41135", "202003") # 아파트매매 실거래자료 조회
df_AptTradeDetail = AptTradeDetail.DataReader("41135", "202003") # 아파트매매 실거래 상세 자료 조회
df_AptRent = AptRent.DataReader("41135", "202003") # 아파트 전월세 자료 조회
df_AptOwnership = AptOwnership.DataReader("41135", "202003") # 아파트 분양권전매 신고 자료 조회
df_OffiTrade = OffiTrade.DataReader("41135", "202003") # 오피스텔 매매 신고 조회
df_OffiRent = OffiRent.DataReader("41135", "202003") # 오피스텔 전월세 신고 조회
df_RHTrade = RHTrade.DataReader("41135", "202003") # 연립다세대 매매 실거래자료 조회
df_RHRent = RHRent.DataReader("41135", "202003") # 연립다세대 전월세 실거래자료 조회
df_DHTrade = DHTrade.DataReader("41135", "202003") # 단독/다가구 매매 실거래 조회
df_DHRent = DHRent.DataReader("41135", "202003") # 단독/다가구 전월세 자료 조회
df_LandTrade = LandTrade.DataReader("41135", "202003") # 토지 매매 신고 조회
df_BizTrade = BizTrade.DataReader("41135", "202003") # 상업업무용 부동산 매매 신고 자료 조회
# 6. 지역, 기간 별 데이터 프레임 만들기
# Function("지역코드 5자리", "시작 년월(YYYY-MM)", "종료 년월(YYYY-MM)")
df_AptTradeSum = AptTrade.DataCollector("41135", "2020-01", "2020-03") # 기타 서비스 함수 동일