{"openapi":"3.0.3","info":{"title":"APICK 매매 시장 분석","version":"1.0.0","description":"지역코드와 계약년월로 한 달 치 매매 실거래를 모아 ㎡당 중위가·평균가, 거래금액·면적·층 분포, 단지별 시세, 직거래·해제 비중과 시세에서 크게 벗어난 거래를 분석합니다. 거래 원문 목록 대신 시세 판단에 바로 쓸 수 있는 집계를 돌려줍니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/rtms_trade":{"post":{"summary":"매매 시장 분석","description":"지역코드와 계약년월로 한 달 치 매매 실거래를 모아 ㎡당 중위가·평균가, 거래금액·면적·층 분포, 단지별 시세, 직거래·해제 비중과 시세에서 크게 벗어난 거래를 분석합니다. 거래 원문 목록 대신 시세 판단에 바로 쓸 수 있는 집계를 돌려줍니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"summary":{"type":"object","properties":{"total":{"type":"integer","description":"분석한 거래 수입니다. 해제된 거래도 포함합니다."},"complex_count":{"type":"integer","description":"서로 다른 단지(단독·다가구는 법정동) 수입니다."},"median_amount":{"type":"integer","description":"거래금액 중앙값(원)입니다. 거래가 없으면 null입니다.","nullable":true},"median_price_per_sqm":{"type":"integer","description":"전용면적 ㎡당 가격의 중앙값(원)입니다. ㎡당 가격 = 거래금액 ÷ 전용면적. 면적을 아는 거래가 없으면 null입니다.","nullable":true},"avg_price_per_sqm":{"type":"integer","description":"㎡당 가격의 평균(원)입니다. 고가·저가 거래에 끌리므로 중앙값과 함께 보세요."},"direct_deal_share_pct":{"type":"integer","description":"직거래 비중(%) = 직거래 건수 ÷ 전체 거래 × 100, 소수 첫째 자리까지 반올림합니다. 거래가 없으면 null입니다.","nullable":true},"canceled_count":{"type":"integer","description":"계약 해제로 신고된 거래 수입니다."},"median_area":{"type":"integer","description":"전용면적 중앙값(㎡, 소수 첫째 자리)입니다."},"median_build_year":{"type":"integer","description":"건축년도 중앙값입니다. 건축년도가 없으면 null입니다.","nullable":true}}},"distribution":{"type":"object","properties":{"by_complex":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"거래 수 상위 10개 단지입니다. 항목은 name·count·share_pct(전체 거래 대비 %, 소수 첫째 자리)입니다."},"by_area_band":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"전용면적 구간별 분포입니다. 항목은 band·count·share_pct이며 40㎡ 미만·40~60㎡·60~85㎡·85~115㎡·115~150㎡는 0건이어도 모두 오고, 150㎡ 이상 거래가 있을 때만 150㎡ 이상이 붙습니다. 각 구간은 앞 값 이상, 뒤 값 미만입니다."},"by_amount_band":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"거래금액 구간별 분포입니다. 3억 미만·3~5억·5~7억·7~10억·10~15억·15~20억은 늘 오고, 20억 원 이상 거래가 있을 때만 20억 이상이 붙습니다."},"by_floor":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"층 구간별 분포입니다. 구간은 지하·1~3층·4~10층·11~20층·21층 이상이고 항목은 band·count·share_pct입니다. 층 정보가 없는 유형은 모든 구간이 0건입니다."}}},"complexes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"단지명(단독·다가구는 법정동 이름)입니다."},"count":{"type":"integer","description":"그 단지의 거래 수입니다."},"median_amount":{"type":"integer","description":"그 단지의 거래금액 중앙값(원)입니다."},"median_price_per_sqm":{"type":"integer","description":"그 단지의 ㎡당 가격 중앙값(원)입니다."},"median_area":{"type":"number","description":"그 단지의 전용면적 중앙값(㎡)입니다."}}},"description":"거래 수가 많은 순서로 최대 20개 단지의 시세 요약입니다."},"anomalies":{"type":"array","items":{"type":"object","properties":{"reasons":{"type":"array","items":{"type":"string"},"description":"판정 사유입니다. 해제·직거래·단지 중위가 대비 -45%처럼 옵니다(음수는 단지 시세보다 낮음)."},"complex":{"type":"string","description":"단지명(단독·다가구는 법정동 이름)입니다."},"umd":{"type":"string","description":"법정동(읍·면·동) 이름입니다."},"area":{"type":"number","description":"전용면적(㎡)입니다. 없으면 null입니다.","nullable":true},"floor":{"type":"integer","description":"층입니다. 없으면 null입니다.","nullable":true},"build_year":{"type":"integer","description":"건축년도입니다. 없으면 null입니다.","nullable":true},"amount":{"type":"integer","description":"거래금액(원)입니다."},"price_per_sqm":{"type":"integer","description":"㎡당 가격(원, 정수로 반올림)입니다."},"deal_type":{"type":"string","description":"거래 유형입니다. 예: 중개거래, 직거래. 없으면 빈 문자열입니다."},"canceled":{"type":"boolean","description":"계약 해제 여부입니다."},"deal_at":{"type":"string","description":"계약일(연-월-일)입니다. 월·일은 앞자리 0 없이 올 수 있습니다. 예: 2026-7-19"}}},"description":"확인이 필요한 거래를 최대 20건 담습니다. 해제 거래, 직거래, 같은 단지 ㎡당 중앙값에서 40% 이상 벗어난 거래가 대상입니다."},"insights":{"type":"array","items":{"type":"string"},"description":"집계에서 뽑은 한국어 요약 문장입니다. 화면에 그대로 보여 줄 수 있습니다."}}},"api":{"type":"object","properties":{"cost":{"type":"integer","description":"차감된 포인트입니다. 실패한 응답은 0입니다."},"success":{"type":"boolean"},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"lawdCd":{"type":"string","description":"지역코드 (법정동코드 앞 5자리, 예: 11110) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"11110"},"dealYmd":{"type":"string","description":"계약년월 (YYYYMM, 예: 202601) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"202607"},"propertyType":{"type":"string","description":"부동산 유형 (기본 apt) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. 가능한 값은 4가지입니다. apt = 아파트를 뜻하는 부동산 유형 값입니다. rh = 연립·다세대 주택을 뜻하는 부동산 유형 값입니다. sh = 단독·다가구 주택을 뜻하는 부동산 유형 값입니다. offi = 오피스텔을 뜻하는 부동산 유형 값입니다. (string)","enum":["apt","rh","sh","offi"],"example":"apt"},"pageNo":{"type":"string","description":"페이지 번호 (기본 1) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)"},"numOfRows":{"type":"string","description":"페이지당 결과 수 (기본 10, 최대 1000) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (integer)","example":"500"}},"required":["lawdCd","dealYmd"]}}}}}}},"x-code-tables":[{"title":"propertyType 허용값","columns":["값","의미"],"rows":[["apt (또는 아파트·apartment)","아파트 (기본값)"],["rh (또는 연립다세대·연립·다세대·rowhouse)","연립·다세대 주택"],["sh (또는 단독다가구·단독·다가구)","단독·다가구 주택. 단지명이 없어 법정동(읍·면·동) 이름으로 묶습니다."],["offi (또는 오피스텔·officetel)","오피스텔"]]},{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["부동산 유형 값 오류","400","부동산 유형이 잘못됐습니다.","propertyType을 허용값 중 하나로 보내거나 생략합니다."],["지역코드 누락·형식 오류","400","지역코드(법정동코드 앞 5자리)가 필요합니다.","숫자 5자리를 보냅니다. 10자리 법정동코드를 넣었다면 앞 5자리만 보냅니다."],["계약년월 누락·자릿수 오류","400","계약년월(YYYYMM)이 필요합니다.","숫자 6자리(YYYYMM)로 보냅니다."],["계약년월 범위 오류","400","계약년월(YYYYMM)이 잘못됐습니다.","월은 01~12, 기간은 200601부터 이번 달까지로 보냅니다."],["일시적 조회 실패","424","실거래가 정보를 가져오지 못했습니다.","잠시 후 같은 요청을 다시 보냅니다."],["포인트 부족","402","결제 금액보다 보유 포인트이 부족합니다.","포인트를 충전한 뒤 다시 요청합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}