{"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":"1: 거래 목록 조회 성공, 0: 지역 이름이 목록에 없음(data.options 확인)."},"data":{"type":"array","items":{"type":"object","properties":{"NO":{"type":"string"},"시군구":{"type":"string","description":"시·군·구와 법정동입니다."},"번지":{"type":"string","description":"번지입니다. 본번·부번은 4자리로 맞춘 값입니다."},"본번":{"type":"string"},"부번":{"type":"string"},"단지명":{"type":"string","description":"단지·건물 이름입니다."},"전용면적(㎡)":{"type":"string","description":"전용면적(㎡)입니다."},"계약년월":{"type":"string","description":"계약 연월 YYYYMM입니다. 계약일과 합쳐 계약일자를 만듭니다."},"계약일":{"type":"string"},"거래금액(만원)":{"type":"string","description":"거래금액(만 원)입니다. 쉼표가 들어 있으므로 숫자로 바꿀 때 쉼표를 지우세요."},"동":{"type":"string"},"층":{"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":"소유권 이전 등기일(YY.MM.DD)입니다. 아직 등기 전이면 -입니다."}}},"description":"거래 목록입니다. 항목 이름은 한글이며 유형(type)에 따라 일부 항목이 다를 수 있으므로 있는 항목만 읽으세요. 값이 없으면 -입니다."},"count":{"type":"integer","description":"조회된 거래 건수입니다."},"success":{"type":"integer"},"msg":{"type":"string","description":"result=0일 때 어느 입력이 틀렸는지 알려 주는 문구입니다."},"options":{"type":"array","items":{"type":"string"},"description":"result=0일 때 입력 가능한 지역 이름 목록입니다."}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다."},"ms":{"type":"integer"},"pl_id":{"type":"integer"}}}}}}}},"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":"주소의 시·군·구 이름입니다. 예: 금천구, 수원시. 시·도(addr1)와 함께 보냅니다. (string)","example":"금천구"},"type":{"type":"string","description":"유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등 (string)","example":"A"},"year":{"type":"string","description":"조회할 연도(4자리)입니다. 1950년부터 현재 연도까지 지원하며, 예: 2025. 최근 연도는 신고·집계 지연으로 자료가 없을 수 있습니다. (string)","example":"2025"}},"required":["addr1","addr2","type","year"]}}}}}}},"x-code-tables":[{"title":"오류 코드","columns":["응답","의미","대처"],"rows":[["data.result=0, data.msg \"[addr1] 입력 항목이 잘못됐습니다.\"","시·도 이름이 목록에 없습니다.","data.options의 이름 중 하나로 다시 요청합니다. 과금되지 않습니다."],["data.result=0, data.msg \"[addr2] 입력 항목이 잘못됐습니다.\"","시·군·구 이름이 그 시·도에 없습니다.","data.options의 이름 중 하나로 다시 요청합니다. 과금되지 않습니다."],["data.error \"[년도] 입력 항목이 잘못됐습니다. ex) 2024\"","year가 숫자가 아니거나 1950~올해 범위 밖입니다.","4자리 연도로 고쳐 보냅니다. 과금되지 않습니다."],["data.error \"[유형] 입력 항목이 잘못됐습니다. ex) A\"","type이 A~H가 아닙니다.","대문자 한 글자로 보냅니다. 과금되지 않습니다."],["data.error \"알 수 없는 이유로 실패했습니다.\"","조회하지 못했습니다.","잠시 후 다시 요청합니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}