{"openapi":"3.0.3","info":{"title":"APICK 부동산 실거래가 조회","version":"1.0.0","description":"부동산의 실제 거래이력을 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/land_rt_price":{"post":{"summary":"부동산 실거래가 조회","description":"부동산의 실제 거래이력을 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"integer","description":"검색 결과 0: 유효하지 않은 시, 도 등 입력 시(options와 함께 응답) 1: 성공 2: 오류(에이픽 서버 오류)(해당 오류 발생 시 요청 내용과 함께 문의글로 남겨주시기 바랍니다.) 3: 오류(처리시간 초과)"},"data":{"type":"array","items":{"type":"object","properties":{"NO":{"type":"string"},"시군구":{"type":"string"},"번지":{"type":"string"},"본번":{"type":"string"},"부번":{"type":"string"},"단지명":{"type":"string"},"전용면적(㎡)":{"type":"string"},"계약년월":{"type":"string"},"계약일":{"type":"string"},"거래금액(만원)":{"type":"string"},"동":{"type":"string"},"층":{"type":"string"},"매수자":{"type":"string"},"매도자":{"type":"string"},"건축년도":{"type":"string"},"도로명":{"type":"string"},"해제사유발생일":{"type":"string"},"거래유형":{"type":"string"},"중개사소재지":{"type":"string"},"등기일자":{"type":"string"}}},"description":"조회 데이터"},"count":{"type":"integer","description":"조회된 총 개수"},"success":{"type":"integer","description":"과금 여부0: 실패1: 성공3: 실패(timeout)"},"msg":{"type":"string","description":"메시지 내용 (result가 0인 경우 반환)"},"options":{"type":"array","items":{"type":"string"},"description":"result가 0인 경우 입력 가능한 값 목록"},"error":{"type":"string","description":"오류 내용 (result가 2,3인 경우 반환)"}},"description":"조회 데이터","items":{"type":"object","properties":{"NO":{"type":"string","description":"NO"},"시군구":{"type":"string","description":"시군구"},"번지":{"type":"string","description":"번지"},"본번":{"type":"string","description":"본번"},"부번":{"type":"string","description":"부번"},"단지명":{"type":"string","description":"단지명"},"전용면적(㎡)":{"type":"string","description":"전용면적(㎡)"},"계약년월":{"type":"string","description":"계약년월"},"계약일":{"type":"string","description":"계약일"},"거래금액(만원)":{"type":"string","description":"거래금액(만원)"},"동":{"type":"string","description":"동"},"층":{"type":"string","description":"층"},"매수자":{"type":"string","description":"매수자"},"매도자":{"type":"string","description":"매도자"},"건축년도":{"type":"string","description":"건축년도"},"도로명":{"type":"string","description":"도로명 주소"},"해제사유발생일":{"type":"string","description":"해제사유발생일"},"거래유형":{"type":"string","description":"거래유형"},"중개사소재지":{"type":"string","description":"중개사소재지"},"등기일자":{"type":"string","description":"등기일자"}}}},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"addr1":{"type":"string","description":"도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시) (string)","example":"서울특별시"},"addr2":{"type":"string","description":"시/군/구 (예: 금천구) (string)","example":"금천구"},"type":{"type":"string","description":"유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등 (string)","example":"A"},"year":{"type":"string","description":"조회 년도 (1950 ~ 현재 년도, 예: 2025) (string)","example":"2025"}},"required":["addr1","addr2","type","year"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}