{"openapi":"3.0.3","info":{"title":"APICK 전월세 시장 분석","version":"1.0.0","description":"지역코드와 계약년월로 한 달 치 전월세 실거래를 모아 전세 비중, 보증금·월세 분포, 보증금 대비 연 월세 비율, 신규·갱신 계약 비중, 단지별 보증금 시세를 분석하고 같은 달 매매 거래와 맞춰 단지별 전세가율을 계산합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/rtms_rent":{"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":"서로 다른 단지(단독·다가구는 법정동) 수입니다."},"jeonse_count":{"type":"integer","description":"전세 계약 수입니다. 월세가 0이고 보증금이 있는 계약을 전세로 셉니다."},"jeonse_share_pct":{"type":"integer","description":"전세 비중(%) = 전세 계약 ÷ 전체 계약 × 100, 소수 첫째 자리까지 반올림합니다. 계약이 없으면 null입니다.","nullable":true},"median_deposit":{"type":"integer","description":"보증금 중앙값(원)입니다. 전세와 월세 계약을 모두 포함합니다."},"median_monthly_rent":{"type":"integer","description":"월세 중앙값(원)입니다. 전세 계약은 월세 0으로 포함되므로 전세 비중이 절반을 넘으면 0이 됩니다."},"median_deposit_per_sqm":{"type":"integer","description":"전용면적 ㎡당 보증금의 중앙값(원)입니다. 면적을 아는 계약이 없으면 null입니다.","nullable":true},"avg_annual_rent_to_deposit_pct":{"type":"number","description":"보증금 대비 연 월세 비율의 평균(%)입니다. 월세가 있는 계약마다 월세 × 12 ÷ 보증금 × 100을 구해 평균합니다. 전세 계약(월세 0)은 평균에서 뺍니다. 월세 계약이 없으면 null입니다. 법정 전환율이 아닌 비교용 지표이고, 소수 둘째 자리까지 반올림합니다.","nullable":true},"renewal_share_pct":{"type":"integer","description":"갱신 계약 비중(%)입니다. 소수 첫째 자리까지 반올림하며 계약이 없으면 null입니다.","nullable":true},"median_jeonse_ratio_pct":{"type":"number","description":"단지별 전세가율의 중앙값(%)입니다. 전세가율을 계산한 단지가 있을 때만 이 필드가 옵니다."}}},"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_deposit_band":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"보증금 구간별 분포입니다. 항목은 band·count·share_pct이며 1억 미만·1~2억·2~3억·3~5억·5~7억은 0건이어도 모두 오고, 7억 원 이상 계약이 있을 때만 7억 이상이 붙습니다. 각 구간은 앞 값 이상, 뒤 값 미만입니다."},"by_monthly_band":{"type":"array","items":{"type":"object","properties":{"band":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"월세 구간별 분포입니다. 30만원 미만·30~50만원·50~80만원·80~120만원·120~200만원은 늘 오고, 200만 원 이상이 있을 때만 200만원 이상이 붙습니다. 전세 계약(월세 0)은 30만원 미만에 들어갑니다."},"by_contract_type":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"count":{"type":"integer"},"share_pct":{"type":"integer"}}},"description":"계약 구분별 분포 상위 5개입니다. name은 신규·갱신이며 구분이 없는 계약은 미상입니다."}}},"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개 단지의 보증금 시세 요약입니다."},"jeonse_ratio":{"type":"object","properties":{"matched_complex_count":{"type":"integer","description":"전세가율을 계산한 단지 수입니다. 전세 계약 3건 이상과 매매 거래 3건 이상이 함께 있는 단지만 셉니다."},"median_jeonse_ratio_pct":{"type":"number","description":"단지별 전세가율의 중앙값(%)입니다. 계산한 단지가 없으면 null입니다.","nullable":true},"complexes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"단지명입니다."},"jeonse_median_deposit":{"type":"integer","description":"그 단지의 전세 보증금 중앙값(원)입니다."},"sale_median_amount":{"type":"integer","description":"그 단지의 매매 거래금액 중앙값(원)입니다."},"jeonse_ratio_pct":{"type":"number","description":"전세가율(%) = 전세 보증금 중앙값 ÷ 매매 거래금액 중앙값 × 100, 소수 첫째 자리까지 반올림합니다."}}},"description":"전세가율이 높은 순서로 최대 10개 단지입니다."}},"description":"같은 단지의 매매가와 비교한 전세가율입니다. 매매 비교를 하지 못한 응답에는 이 필드가 없습니다."},"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"},"includeTrade":{"type":"string","description":"같은 단지 매매가와 비교한 전세가율(jeonse_ratio) 포함 여부 (기본 true) true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"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"}}}}