먼저 기억할 것

동네·단지 이름은 API 조회 범위 자체가 아닙니다. 이 저장본은 지역 코드 11110의 36행에서 창신쌍용2 6행, 전용면적 64.66㎡ 2행으로 좁혀집니다. 같은 이름을 보더라도 코드·기간·추가 필터가 다르면 비교 대상과 분모가 달라집니다. 36→6→2의 입력·검산에서 조건을 확인하세요.

동네 이름과 조회 범위 구분: 지역 이름, 조회 코드, 계약월
AI 생성 개념도 · 동네 이름과 실제 조회 코드·계약월·범위를 따로 확인하는 개념도입니다. 실제 행정 경계 지도나 현재 조회 결과가 아닙니다. 본문 근거와 적용 조건 · 그림을 누르면 원본 크기로 볼 수 있습니다.

이름과 범위를 함께 기록하기

사람이 사용하는 동네 이름은 친숙하지만 데이터는 지역 코드와 주소 항목으로 구분되는 경우가 많습니다. 같은 이름을 가진 단지가 여러 지역에 있거나 단지 표기 방식이 다르면 이름만으로 조회 대상을 확정하기 어렵습니다.

검색 메모에는 단지명뿐 아니라 시·도와 시·군·구, 가능한 주소 정보도 함께 적습니다. 이름이 비슷한 거래가 나타나면 금액 비교 전에 같은 대상인지부터 확인하세요.

코드와 계약월이라는 조회 조건

코드와 계약월이라는 조회 조건의 판단 조건을 설명하는 개념 그림
AI 생성 개념도 · 코드와 계약월이라는 조회 조건에 관한 설명용 그림입니다. 구체적인 조건·계산·확인 범위는 아래 본문을 따르며, 실제 화면이나 관찰·측정 자료가 아닙니다. 본문 근거와 적용 조건 · 그림을 누르면 원본 크기로 볼 수 있습니다.

국토교통부 아파트 실거래 API 안내는 법정동 코드 앞 다섯 자리와 여섯 자리 계약 연월을 조회 조건으로 설명합니다. 이것은 화면에 표시되는 단지명 검색과는 다른 층위의 조건입니다.

여기서는 요청의 지역 조건 11110과 결과 안의 법정동·단지 필터를 분리합니다. 11110으로 저장한 36행 전체는 창신쌍용2의 36건이 아닙니다. 그 안에서 단지명이 정확히 창신쌍용2인 6행, 다시 전용면적이 64.66㎡인 2행으로 좁히는 단계가 추가됩니다. 표에 적는 분모도 각각 36·6·2로 달라집니다. 검색창에 단지명을 넣었다는 이유로 원 API가 단지별로 조회됐다고 설명하면 이 단계를 잃습니다.

결과가 없을 때 확인하는 순서

이 저장본에서는 먼저 지역 코드 11110의 36행인지 확인하고, 그 안에서 법정동·단지명·면적·계약월을 차례로 좁힙니다. 결과가 0건이 된 단계의 직전 조건과 건수를 남기면 ‘그 지역에 거래가 없음’과 ‘내 세부 필터에 맞는 행이 없음’을 나누어 설명할 수 있습니다.

검색어를 넓혀 결과가 나왔다면 주소를 확인하고 다시 좁혀야 합니다. 이름 일부가 같은 다른 단지까지 섞으면 빈 결과 문제를 해결하는 대신 잘못된 비교 대상이 늘어납니다.

비교표 제목에 범위를 쓰기

최종 표 제목에는 실제 사용한 코드·주택 유형·거래 유형·계약월과 추가 필터를 넣습니다. ‘종로구 아파트 매매 저장자료 중 특정 단지·면적 조건’의 결과를 ‘서울 실거래’나 그 단지 전체의 거래량으로 바꾸어 부르면 조회 범위가 달라집니다. 사람이 읽는 이름과 계산에 사용한 조건을 함께 보존하세요.

지역 경계나 표기 방식이 달라진 자료를 비교할 때는 이전 표와 현재 표의 범위가 같은지 확인합니다. 행이 늘거나 줄었다는 사실만으로 시장 변화를 설명하기 전에 검색 범위의 변화부터 배제해야 합니다.

지역 코드 11110 안의 법정동을 직접 세어 보기

저장자료 재검산: 2026-10-18. 8월분 저장은 9월 30일 06:41:55, 9월분은 10월 6일 06:40:11(KST)입니다. 현재 자료를 새로 조회하지 않았습니다.

하나의 시군구 조회 결과에 여러 법정동이 포함됩니다
저장 행의 법정동8·9월 합계 건수
교북동2
내수동3
명륜2가2
무악동3
부암동1
사직동3
숭인동6
연건동1
인의동1
창신동10
청운동1
평창동2
필운동1

조회 지역 코드는 11110이고, 저장 행의 원본 필드 sggCd도 11110입니다. 이 시군구 범위의 결과 안에 무악동·숭인동·창신동 등 서로 다른 법정동이 들어 있습니다. ‘동 이름을 입력했다’와 ‘그 동만 API로 조회했다’는 같은 설명이 아닙니다.

독자는 전체 CSV에서 지역코드, 법정동, 단지명 순서로 필터를 적용해 이 표를 다시 셀 수 있습니다. 이는 종로구 저장 표본 내부의 구성입니다. 다른 지역의 같은 단지명을 조사하거나 법정동 경계 변경 이력을 검증한 자료는 아닙니다. 세부 면적 필터가 빈 결과를 만드는 과정은 실제 2→1→0건 사례에서 확인할 수 있습니다.

36→6→2의 분모를 원본 CSV로 다시 세기

아래 CSV와 검산 코드를 함께 받으면 표의 법정동별 건수와 36→6→2행을 직접 대조할 수 있습니다. 스크립트는 CSV의 실제 열을 읽어 지역 코드 11110, 단지명 창신쌍용2, 전용면적 64.66㎡를 차례로 적용합니다. 면적은 이진 부동소수점의 근삿값 대신 십진수로 비교합니다.

CSV와 코드를 같은 폴더에 저장한 뒤 Python 3으로 실행합니다. 결과 파일이 이미 있으면 다른 --output 이름을 지정합니다. 원본 CSV는 수정하지 않습니다.

python3 check-region-scope.py --csv jongno-transactions-20261007.csv --output region-scope-check.json

연결한 저장본에서는 지역 조건 36행 → 단지 조건 6행 → 면적 조건 2행이고, 지역 조건의 법정동은 13개입니다. 결과 JSON의 village_counts로 위 표를, matched_rows로 마지막 2행을 대조할 수 있습니다. 지역·단지·면적을 바꾸려면 코드의 --region·--apartment·--area 인자를 사용합니다. 결과가 0이면 그 CSV와 필터 조합의 0행이며 실제 지역 전체의 거래 부재를 뜻하지 않습니다.

잘못된 코드와 유효한 조건의 0행을 구분합니다

--region에는 공백 없는 ASCII 숫자 다섯 자리를 넣습니다. 이전 코드는 1111이나 11110x도 정상 실행으로 처리해 0행 JSON을 저장했습니다. 현재 코드는 이런 입력을 오류로 거절하고 결과 파일을 만들지 않습니다. 반면 형식이 맞는 11680은 이 종로구 저장 CSV 안에서 0행이라는 결과를 유지합니다. 다섯 자리라는 형식 검사는 실제로 배정된 지역 코드인지 확인하는 기능이 아니며, CSV에 없다는 결과도 그 지역의 실제 거래 부재를 뜻하지 않습니다.

같은 원본 CSV에서 정상 지역 11110의 36→6→2행은 그대로입니다. 잘못된 코드와 유효한 빈 결과를 나눠 확인한 수정 전후 결과, 일곱 입력을 확인하는 검사 코드, 보존한 수정 전 코드를 제공합니다.

현재 검산 코드·원본 CSV·검사 코드를 같은 폴더에 내려받아 아래 명령으로 확인합니다. 검사는 자체 임시 결과 파일만 만들고 정리하며 원본 CSV를 바꾸거나 외부 API에 접속하지 않습니다.

python3 check-region-code-contract.py check-region-scope.py jongno-transactions-20261007.csv

입력 구분 보강 2026-11-09. 코드 형식 오류를 정상적인 0행과 구분했습니다. 원본 저장 시각·발행일·36행·기존 표의 값은 유지했습니다.

검산 경로 추가 2026-11-03. 2026년 8·9월 계약의 기존 저장본을 다시 계산했습니다. 최초 발행일, 원본 저장 시각과 앞의 집계표는 유지했으며 새 실거래 조회를 한 것이 아닙니다.

읽고 나서 확인할 것

  • 단지명과 지역을 함께 확인했는가?
  • 계약월과 거래 유형이 맞는가?
  • 표 제목이 실제 조회 범위를 표현하는가?

편집자 의견

동네를 비교하는 표에는 사람이 읽는 이름과 조회 코드·계약월을 함께 남기는 편을 권합니다. 코드 11110 안에도 여러 법정동이 들어 있어 표시 이름만으로 다른 검색의 범위를 동일하다고 보기 어렵습니다.

결과가 비어 있다면 먼저 지역·유형·기간이 의도와 맞는지 확인하겠습니다. 범위를 넓혀 자료를 얻었다면 그 결과는 더 넓은 질문의 답이므로 이전 제목을 그대로 붙이지 않습니다.

판단 근거: 지역 코드 11110 안의 법정동을 직접 세어 보기

의견 추가 2026-10-23 · 본문 자료를 바탕으로 한 편집 판단

참고 자료와 확인 범위

  1. 국토교통부 · 아파트 매매 실거래가 자료
  2. 국토교통부 · 아파트 전월세 실거래가 자료
  3. 행정표준코드관리시스템 · 법정동 코드

원문 확인: 2026년 10월 7일 · 오류·정정 제보