Data Sources
데이터 출처
본 서비스에서 표시하는 모든 부동산 거래 데이터는 국토교통부 실거래가 공개시스템에서 제공하는 공공데이터를 기반으로 합니다.
원천 데이터
공공데이터
국토교통부 실거래가 공개시스템
실거래된 아파트 매매 계약 내역을 공개하는 국가 공공 API 서비스입니다.
공공데이터포털(data.go.kr)을 통해 무료로 제공됩니다.
공공데이터 이용 안내: 본 서비스에서 사용하는 데이터는
공공누리 제1유형(출처 표시)에 따라 이용 가능한 공공데이터입니다.
원본 데이터는 국토교통부 실거래가 공개시스템에서 확인할 수 있습니다.
수집 대상
| 거래 유형 | 아파트 매매 (전세·월세·빌라·오피스텔 제외) |
| 대상 지역 | 수도권 — 서울특별시(25구), 경기도(31시·군), 인천광역시(10구·군), 총 66개 시·군·구 |
| 수집 기간 | 최근 10년 (장기 비교 차트), 일 배치는 최근 9개월 갱신 |
| 수집 단위 | 실거래 건별 (계약일, 거래금액, 면적, 단지명, 소재지) |
데이터 수집·처리 파이프라인
01
API 수집
공공데이터포털 API 호출 (지역·월별)
02
스냅샷 저장
월별 gzip 캐시로 로컬 저장 (재수집 방지)
03
중위가 집계
구·동 단위 기간별 중위가 계산
04
랭킹 산출
등락률 정렬 → JSON 파일 저장
05
화면 표시
정적 파일 서빙 → 브라우저 렌더링
수집·처리는 매일 1회 자동으로 실행되며, 신규 거래 데이터가 있는 경우 랭킹이 갱신됩니다.
원천 데이터 필드 정의
국토교통부 API에서 제공하는 주요 필드와 본 서비스에서의 활용 방식입니다.
| API 필드명 | 내용 | 서비스 활용 |
|---|---|---|
dealAmount |
거래금액 (만원 단위, 쉼표 포함 문자열) | 중위가·평균가 산출 기준 |
dealYear / dealMonth / dealDay |
계약 연·월·일 | 기간별 필터링 기준일 |
sggCd |
시·군·구 코드 (5자리) | 구 단위 집계 기준 |
umdNm |
법정동명 (읍·면·동) | 동 단위 집계 기준 |
aptNm |
아파트명 | 단지별 드릴다운·검색 |
excluUseAr |
전용면적 (㎡) | 개별 거래 정보 표시 |
데이터 정제 과정
원천 데이터를 그대로 사용하지 않고 다음 정제 과정을 거칩니다.
- 금액 파싱: API 응답의 쉼표 포함 문자열(예: "7,500")을 숫자로 변환
- 이상치 제거: 0원 이하 또는 비정상적인 값(isFinite 검증 실패)은 집계에서 제외
- 최소 거래건수 필터: 구 단위 5건 미만, 동 단위 3건 미만 지역은 집계 제외
- 양방향 기간 검증: 현재 기간과 비교 기간 양쪽 모두 최소 건수를 충족해야 등락률 산출
가족 간 거래 등 특수 거래: 현재는 별도 필터링 없이 포함됩니다.
국토교통부 API 자체적으로 신고된 모든 거래를 제공하므로, 시장 외 거래가 일부 포함될 수 있습니다.
업데이트 주기 및 반영 시차
| 배치 실행 주기 | 매일 1회 (일 배치) |
| 실거래 신고 기한 | 계약일로부터 30일 이내 (부동산거래신고 등에 관한 법률 제3조) |
| 실질 반영 시차 | 계약 후 최대 30일 + 배치 실행 시간 |
| 수정 신고 처리 | 해당 월 스냅샷을 최근 3개월은 매일 재수집하여 수정 반영 |