아파트 외 부동산 검색
search_propertiesRead-onlyIdempotent
빌라(연립·다세대)·오피스텔·단독다가구·토지·상가/사무실·아파트 분양권의 실거래를 지역별로 준다. "송파구 빌라 시세", "제주 토지 평당가", "강남 상가 얼마"처럼 아파트가 아닌 질문에 쓴다. ★아파트는 이 도구가 아니라 search_apartments를 쓸 것 — 둘은 데이터가 완전히 분리돼 있다. ★지역(sido+gu)이 반드시 필요하다. 전국 단위 목록은 주지 않는다 — 빌라만 24만 곳이라 한 번에 줄 수 없고, 준다 해도 읽을 수 없다. ★집계 단위가 유형마다 다르다: 빌라·오피스텔·분양권은 단지, 단독·토지·상가는 법정동이다 (응답의 unit이 알려준다). 단독·토지·상가에서 name은 건물 이름이 아니라 동 이름이다. ★AI 예측(fc)은 없다. 빌라는 단지당 20년에 10건꼴이라 예측이 성립하지 않는다 — 있는 척하지 말고 "실거래 통계"로만 답할 것.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gu | Yes | 시군구. 예: 송파구, 제주시 | |
| kind | Yes | villa=연립다세대 · officetel=오피스텔 · detached=단독다가구 · land=토지 · commercial=상가/사무실/건물 · presale=아파트 분양권 · ★_rent가 붙으면 **전월세**다(villa_rent·officetel_rent·detached_rent) — rep_price 대신 jtot(전세 대표가)·wolse_med(중위 월세)를 본다 · subscription=청약(분양 공고, 실거래 없음) · rental=공공임대(LH·마이홈 공급정보, 실거래 없음) · auction=공매(온비드, 금액은 감정가이며 실거래가 아님) | |
| sido | No | 시도. 예: 서울, 제주. (광주는 전남광주로 정규화된다) | |
| sort | No | 정렬 축. 기본 n_total(거래 많은 순). ★유형에 없는 축으로 정렬하면 순서가 무의미해진다 — 전월세는 jtot·wolse_med, 공매는 min_low, 청약은 sub_end를 쓴다 | |
| limit | No | 1~100, 기본 20 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deal | No | '매매' 또는 '전월세'. ★label은 둘 다 '빌라'라 이 축으로 갈라야 한다 | |
| kind | Yes | ||
| unit | Yes | '단지' 또는 '법정동' — items의 name이 무엇인지 알려준다 | |
| items | Yes | 유형에 따라 담기는 축이 다르다. ★단위는 응답의 units를 그대로 읽을 것 — 지어내면 100배·1만배 틀린다 | |
| label | No | 유형 이름(빌라·토지 등) | |
| total | Yes | 그 지역의 전체 단위 수(반환 건수가 아니다) | |
| units | Yes | 축 이름 → 단위·뜻 설명. 숫자를 옮길 때 이 값을 그대로 읽는다 | |
| notice | No | 참고용 통계라는 고지. 투자 자문·중개가 아니다 | |
| region | No | ||
| source | Yes | 데이터 출처와 갱신일 | |
| returned | Yes | ||
| no_trades | No | 있으면 실거래가 아니다(청약=공고가·공매=감정가). 시세로 인용하지 말 것 |