지역 스캔
area_scanScan commercial building sales in Seoul by district or neighborhood. Filter by price per pyeong and road name to view recent transactions and statistics.
Instructions
구·동 단위 상업업무용(통건물) 시세 — 동이면 후보 거래까지, 구면 통계·동별 순위.
area 에 구만 주면('강남구') 구 모드, 동을 주면('대치동') 동 모드다. 지번을 몰라도 '동 + 가격대'로 조회한다. 예: area='성수동1가', min_eok_per_pyeong=4.5, max_eok_per_pyeong=5.5 → 연면적 평당 4.5~5.5억 거래를 최신순으로. min/max 가 0 이면 해당 방향 제한 없음. 평당가 기준 = 연면적(거래금액÷연면적평). road_contains(예: '연무장길')를 주면 표제부 역매칭으로 도로명이 특정된 거래만 부분일치 필터 — 도로명 미상(마스킹 미복원) 거래는 제외되며 그 건수를 함께 고지한다. 서울 상업업무용 매매 한정(v1). 첫 조회는 표제부 API 로딩으로 수십 초 걸릴 수 있다. 표본 대표성을 판단할 때는 structuredContent 의 coverage(모수 분해)를 함께 읽을 것.
취급 범위는 통건물(유형='일반')뿐 — 집합(구분상가)은 제외한다(coverage.jiphap_excluded 에 건수). 그러므로 stats 는 전부 '통건물 시세'이며, 상가 한 칸 시세가 아니다.
area 에 구만 주면('강남구'·'강남') 구 모드로 동작한다 — 구 전체 시세와 분기 추이, 그리고 by_dong(동별 대지 평단가 내림차순)을 낸다. 구 모드는 표제부 역매칭을 돌리지 않아 deals 가 항상 비어 있다(scope='구' 로 구분). 개별 지번·거래가 필요하면 동으로 다시 부를 것.
동 평균 평단가는 stats(연면적·대지)에 담긴다 — 가격대·도로명 필터와 무관하게, 표제부 역매칭 이전의 국토부 원본 실거래(통건물, 해제·산출불가 제외)로 산출하므로 전수에 가깝다. '이 동 평단가 시세'를 물으면 deals 가 아니라 stats 를 근거로 답할 것 (deals 는 필터 통과분이라 평균 내면 편향된다). 평균이 필요할 뿐이면 min/max 를 주지 말고(밴드 없이) 호출하면 된다.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | Yes | ||
| limit | No | ||
| months | No | ||
| road_contains | No | ||
| max_eok_per_pyeong | No | ||
| min_eok_per_pyeong | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | ||
| deals | Yes | 최신순. 평단가 기준은 연면적(거래금액 ÷ 연면적평). | |
| query | Yes | ||
| scope | No | '구' 면 구 전체 통계 모드 — deals 는 항상 비어 있고(역매칭 미실행) by_dong 에 동별 순위가 담긴다. 개별 지번이 필요하면 동으로 다시 조회할 것. | |
| stats | No | 동 전체 평단가 시세 — 사용자 가격대·도로명 필터와 무관하게, 표제부 역매칭 이전의 국토부 원본 실거래(해제·산출불가 제외)로 산출. deals(필터 통과분)와 달리 표본이 줄지 않아 평균이 편향되지 않는다. | |
| filter | No | 실제 적용된 필터(클램프·스왑 후 값). | |
| source | Yes | ||
| status | Yes | OK 일 때만 deals 에 실측값이 있다. 그 외에는 수치를 추측·보간하지 말 것. | |
| by_dong | No | 구 모드 전용 — 동별 평단가(대지 중앙값 내림차순). 동 모드에서는 빈 배열. | |
| message | No | ||
| coverage | No | 모수 분해 — matched 만 보지 말고 무엇이 왜 빠졌는지 함께 읽을 것. | |
| lookup_status | No | 도메인 원본 상태(거래있음/조건_불일치/거래없음 …) | |
| period_months | Yes |