핵심 답변
국토교통부의 아파트 매매 실거래가 Open API는 공공데이터포털에서 신청해 사용할 수 있는 REST API입니다. 법정동 코드의 앞 5자리 지역코드와 계약년월 6자리를 입력해 해당 지역·기간의 아파트 매매 신고자료를 조회합니다. 데이터는 「부동산 거래신고 등에 관한 법률」에 따라 신고된 자료이며 XML 형식으로 제공됩니다.
1. 어디서 신청하나
공공데이터포털에서 “국토교통부 아파트 매매 실거래가 자료” Open API를 찾아 활용신청합니다.
개발계정은 자동승인 방식으로 안내되어 있고, 기본 호출량과 운영계정 증량 조건은 포털의 현재 이용조건을 확인합니다.
2. 주요 조회조건은 지역코드와 계약년월이다
공식 설명은 행정표준코드관리시스템의 법정동 코드 중 앞 5자리와 계약년월 6자리를 이용해 해당 지역·기간을 조회한다고 안내합니다.
예를 들어 서울 종로구는 11110처럼 시군구 단위 코드로 조회하며, 계약년월은 202609 같은 형식으로 사용합니다.
3. 단지명 검색 API와는 구조가 다르다
실거래가 API는 사용자가 포털 화면처럼 단지명을 입력해 바로 검색하는 방식보다 지역코드와 계약월 범위를 먼저 조회하는 구조에 가깝습니다.
대량 수집 서비스는 결과를 저장한 뒤 아파트명·주소·단지 식별값 등을 자체적으로 정리해 검색기능을 만드는 경우가 많습니다.
4. 공개되는 항목에는 개인정보 제한이 있다
공공데이터포털은 개인정보보호를 위해 아파트의 층정보를 제공하고, 소유권 이전등기가 완료된 건에 한해 동정보가 추가 공개된다고 설명합니다.
따라서 모든 거래에서 정확한 동·호수를 API로 받을 수 있다고 가정하면 안 됩니다.
5. 최근 데이터는 신고 시차를 고려한다
API가 최신이라고 해도 아직 신고되지 않은 최근 계약까지 보여주는 것은 아닙니다. 매매계약은 계약일부터 30일 이내 신고 구조이므로 최근 계약월 데이터는 시간이 지나며 추가될 수 있습니다.
실거래 신고 지연 이해하기에서 이 차이를 설명합니다.
6. 기본 사용 흐름
| 단계 | 내용 |
|---|---|
| 1 | 공공데이터포털 활용신청 |
| 2 | 서비스키 발급·확인 |
| 3 | 법정동 앞 5자리 지역코드 준비 |
| 4 | 계약년월 6자리 지정 |
| 5 | XML 응답 저장·가공 |
7. earth2city도 원자료와 가공결과를 구분한다
earth2city는 국토교통부 실거래 데이터를 수집해 단지·전용면적 단위로 정리하고, 해제 거래와 신고가 같은 파생정보를 별도 로직으로 계산합니다.
원자료 자체와 사이트가 계산한 지표는 구분해서 보는 것이 중요합니다. 신고가 집계 기준에서 가공 규칙을 공개하고 있습니다.
8. FAQ
Q. 아파트 실거래가 API는 무료인가요?
A. 공공데이터포털 현재 안내상 비용부과 없음으로 제공됩니다. 호출량과 운영조건은 활용신청 화면의 최신 조건을 확인하십시오.
Q. 주소 전체를 넣으면 조회되나요?
A. 공식 API 설명은 법정동 코드 앞 5자리와 계약년월을 주요 조회조건으로 안내합니다. 주소 검색은 별도 코드 변환이나 자체 검색단계가 필요할 수 있습니다.
Q. 동·호수까지 모두 받을 수 있나요?
A. 아닙니다. 공식 설명은 개인정보보호를 위해 층정보를 제공하고 소유권 이전등기 완료 건에 한해 동정보를 추가 공개한다고 안내합니다.
Q. API 결과가 오늘 체결된 모든 거래를 포함하나요?
A. 아닙니다. 실제 계약과 신고 사이에 최대 법정 신고기한만큼 시차가 생길 수 있습니다.
9. 관련 링크
출처 · 기준일
- 공공데이터포털 「국토교통부_아파트 매매 실거래가 자료」
- 국토교통부 실거래가 공개시스템
- 확인일: 2026-09-23