최고수 공작소

아파트 매매 실거래가 — 국토교통부

국토교통부에 신고된 아파트 매매 계약 하나하나입니다. 거래금액·전용면적·단지 이름·층·건축년도·거래일과, 계약이 해제됐는지·중개거래인지 직거래인지가 들어 있습니다. 시·군·구 코드와 계약 달을 지정해 받는 구조라 전국 한 달치를 받으려면 시·군·구 256곳을 한 번씩 부릅니다. 이 사이트는 ㎡당 매매가의 중앙값을 시·군·구별로 내는 데 씁니다 — 평균은 내지 않습니다.

인용과 내려받기

국토교통부, 「아파트 매매 실거래가 — 국토교통부」, 2026-09-10 기준. 최고수 공작소 가공. https://python-choigosu.com/data/apt-trade-2026/ (확인일: YYYY-MM-DD).

기준일 2026-09-10 은 원본 기관이 공개한 자료의 날짜이고, 최종 수집은 2026-09-10 입니다. 이 주소는 최신 수집분을 가리키므로, 특정 시점을 인용하실 때는 위 기준일을 함께 적어 주십시오 — 그 시점의 원본은 아래 스냅샷 이력에 그대로 남아 있습니다.

CSV 재배포 없음 — 위 접근 경로의 원본이 전체입니다 기관 원본 페이지 필드 사전

UTF-8 BOM 을 붙였습니다. 한국어 Windows 의 Excel 은 BOM 이 없는 UTF-8 CSV 를 cp949 로 해석해 상호와 주소가 전부 깨집니다. 이 파일의 1차 독자가 기자와 연구자이고 그들이 여는 도구가 대부분 Excel 이므로, 그쪽이 바로 열리는 쪽을 골랐습니다. pandas·R·duckdb 로 읽으실 때는 인코딩을 utf-8-sig 로 지정하시면 됩니다 (지정하지 않으면 첫 열 이름 앞에 보이지 않는 문자가 붙습니다 — 그렇게 눈에 보이는 실패가 되도록 고른 것입니다). 줄바꿈은 CRLF(RFC 4180), 참·거짓 항목은 참일 때 Y, 아니면 빈 칸입니다.

이용조건이 미확인인 동안 원본 전량을 그대로 재배포하지 않으며, 이 CSV 는 주소를 정리하고 시군구 코드를 붙인 가공본입니다.

출처와 이용조건

아파트 매매 실거래가 — 국토교통부의 출처 기관·원본·이용조건·마지막으로 받은 때·담긴 곳 수
자료 IDapt-trade-2026
출처 기관국토교통부
원본 https://www.data.go.kr/data/15126468/openapi.do
이용조건 이용허락범위 제한 없음

공공데이터포털이 「이용허락범위 제한 없음」으로 밝히고 있습니다 [확인 2026-09-10]. 별도 조건이 붙지 않으므로 영리 목적 이용과 재배포에 제한이 없습니다.

데이터 기준일
최종 수집
담긴 곳 0
기간2026-06/2026-07
지역대한민국
새로 고침 주기 주 1회 자동으로 받습니다. 30일이 넘으면 늦어졌다고 적음
쓰는 도구 전국 아파트 평당가 지도 (준비 중)

어느 경로로 받았나

재현에 필요한 것을 전부 적습니다. 공식 오픈API 인지 아닌지도 그대로 밝힙니다 — 경로를 숨기면 재현할 수 없고, 재현할 수 없는 자료는 인용할 가치가 없습니다.

  1. 공공데이터포털 오픈API 인증 필요

    https://apis.data.go.kr/1613000/RTMSDataSvcAptTrade/getRTMSDataSvcAptTrade

    파라미터 LAWD_CD(시·군·구 5자리) · DEAL_YMD(YYYYMM) · numOfRows · pageNo · serviceKey (DATA_GO_KR_KEY)

    활용신청 승인은 즉시 났습니다 [확인 2026-09-10]. 개발계정은 하루 1,000회까지라 전국 한 달치(256회)를 하루에 서너 달 받을 수 있고, 지난 자료는 여러 날에 나눠 받습니다. 한 시·군·구의 한 달 거래는 많아야 1,073건이라 2,000건 한 쪽에 다 들어옵니다 [실측 2026-07].

커버리지

아파트 매매 실거래가 — 국토교통부의 지역 커버리지
범위2026년 6·7월 계약분부터 받기 시작했고, 지난 달들은 하루 한도 안에서 거슬러 올라가며 채웁니다. 2026-07 한 달 전국 43,268건이며 시·군·구 256곳 전부 응답합니다 — 2026-07-01 인천 개편 후 새 구 4곳(제물포·영종·서해·검단)도 국토교통부가 새 코드로 냅니다. 해제된 계약이 3.1%, 직거래가 7.4%입니다 [실측 2026-09-10]. 계약 신고 기한이 30일이라 가장 최근 달은 다음 달에 건수가 늘어납니다.
데이터가 있는 지역 0개 시군구 · 0개 시도
지역 페이지 0개. 담긴 곳이 3건 미만인 지역은 만들지 않습니다 — 내용 없는 페이지를 대량 생산하지 않기 위해서입니다.
지역 미매칭 기록 없음

스냅샷 이력

받은 원본을 항목을 골라내지 않고 통째로 압축해 보관해 둡니다. 필요한 것만 남기면 공공데이터의 항목이 바뀐 사실 자체를 영원히 알 수 없기 때문입니다. 원본 API 가 죽어도 이 스냅샷만으로 사이트를 다시 빌드할 수 있습니다.

아직 보관된 스냅샷이 없습니다.

가공 산출물: data/dist/apt-pyeongdanga/index.json 519B · data/dist/apt-pyeongdanga/meta.json 568B

보존 정책 — 최신 1개와 매월 1일자 수집분은 영구 보관하고, 그 사이 주간 수집분은 정리합니다.

알려진 한계

  • 시세나 감정가가 아닙니다. 국토교통부에 신고된 실제 매매 계약의 ㎡당가 중앙값입니다 — 그 동네의 어느 집 한 채 값도 이 수와 같지 않습니다.
  • 가장 최근 달은 아직 신고되지 않은 계약이 있습니다. 신고 기한이 계약 뒤 30일이라 다음 달에 건수가 늘고 값이 바뀔 수 있습니다.
  • 해제된 계약은 값을 내는 데서 뺐습니다. 몇 건을 뺐는지는 자료 설명에 적었습니다.
  • 직거래도 포함합니다. 중개거래보다 낮게 신고되는 경향이 알려져 있지만, 무엇이 참값인지 저희가 정할 수 없어 빼지 않았습니다.
  • 아파트만입니다. 빌라·오피스텔·단독주택 거래는 이 자료에 없습니다.
  • 거래가 3건 미만인 시·군·구는 값을 내지 않습니다(빗금). 두 건의 중앙값은 동네 값이 아닙니다.
  • 법정동 기준 자료라 지도의 읍·면·동 경계와 어긋납니다. 그래서 시·군·구 단위로만 냅니다.

여기 적힌 출처나 이용조건이 틀렸다면 알려 주세요.

형식

아래 열 이름이 CSV 의 머리글이자 JSON 파일의 키입니다. 채움률은 이번 수집분 0건을 직접 세어 계산했습니다. 참·거짓 항목은 참인 건수만 셉니다 — 원본이 참일 때만 기록하기 때문입니다.

아파트 매매 실거래가 — 국토교통부의 필드 목록과 채움률
이름 채움률 설명
aptNm 단지 string 0.0% (0) 아파트 단지 이름. 원본 표기 그대로입니다.
원본 항목 aptNm
dealAmount 거래금액 number 0.0% (0) 만원 단위. 원본은 쉼표가 든 문자열이라 정수로 바꿉니다.
원본 항목 dealAmount
excluUseAr 전용면적 number 0.0% (0) ㎡. 공급면적이 아닙니다 — 평 환산은 이 값으로 합니다.
원본 항목 excluUseAr
floor number 0.0% (0) 거래된 집의 층.
원본 항목 floor
buildYear 건축년도 number 0.0% (0) 준공 연도.
원본 항목 buildYear
dealDate 계약일 string 0.0% (0) 계약 연·월·일. 신고일이 아니라 계약일입니다.
원본 항목 dealYear · dealMonth · dealDay
umdNm 법정동 string 0.0% (0) 법정동 이름. 행정동이 아니라 지도의 읍·면·동 경계와 어긋날 수 있어 시·군·구 단위로만 씁니다.
원본 항목 umdNm
sggCd 시·군·구 string 0.0% (0) 행정안전부 5자리 코드와 같은 체계입니다.
원본 항목 sggCd
cdealType 해제 string 0.0% (0) 계약이 해제되면 O. 해제된 거래는 값을 내는 데서 빼고 건수만 밝힙니다.
원본 항목 cdealType · cdealDay
dealingGbn 거래유형 string 0.0% (0) 중개거래 또는 직거래. 직거래도 포함하되 건수를 밝힙니다.
원본 항목 dealingGbn
rgstDate 등기일 string 0.0% (0) 소유권 이전 등기일. 비어 있는 계약이 많습니다.
원본 항목 rgstDate

도구 11 제때 받음 쓰는 자료 11 받은 때 2026-09-10 23:36 KST 알려진 문제 자료 전부