# 부동산 실거래가 조회 부동산의 실제 거래이력을 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/land_rt_price 응답 필드 - `data` (object): 조회 데이터 - `data.result` (integer): 검색 결과 0: 유효하지 않은 시, 도 등 입력 시(options와 함께 응답) 1: 성공 2: 오류(에이픽 서버 오류)(해당 오류 발생 시 요청 내용과 함께 문의글로 남겨주시기 바랍니다.) 3: 오류(처리시간 초과) - `data.data` (array): 조회 데이터 - `data.data[].NO` (string): 아래 하위 항목을 확인하세요. - `data.data[].시군구` (string): 아래 하위 항목을 확인하세요. - `data.data[].번지` (string): 아래 하위 항목을 확인하세요. - `data.data[].본번` (string): 아래 하위 항목을 확인하세요. - `data.data[].부번` (string): 아래 하위 항목을 확인하세요. - `data.data[].단지명` (string): 아래 하위 항목을 확인하세요. - `data.data[].전용면적(㎡)` (string): 아래 하위 항목을 확인하세요. - `data.data[].계약년월` (string): 아래 하위 항목을 확인하세요. - `data.data[].계약일` (string): 아래 하위 항목을 확인하세요. - `data.data[].거래금액(만원)` (string): 아래 하위 항목을 확인하세요. - `data.data[].동` (string): 아래 하위 항목을 확인하세요. - `data.data[].층` (string): 아래 하위 항목을 확인하세요. - `data.data[].매수자` (string): 아래 하위 항목을 확인하세요. - `data.data[].매도자` (string): 아래 하위 항목을 확인하세요. - `data.data[].건축년도` (string): 아래 하위 항목을 확인하세요. - `data.data[].도로명` (string): 아래 하위 항목을 확인하세요. - `data.data[].해제사유발생일` (string): 아래 하위 항목을 확인하세요. - `data.data[].거래유형` (string): 아래 하위 항목을 확인하세요. - `data.data[].중개사소재지` (string): 아래 하위 항목을 확인하세요. - `data.data[].등기일자` (string): 아래 하위 항목을 확인하세요. - `data.count` (integer): 조회된 총 개수 - `data.success` (integer): 과금 여부0: 실패1: 성공3: 실패(timeout) - `data.msg` (string): 메시지 내용 (result가 0인 경우 반환) - `data.options` (array): result가 0인 경우 입력 가능한 값 목록 - `data.error` (string): 오류 내용 (result가 2,3인 경우 반환) - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): API 호출 요금 - `api.ms` (integer): API 응답 시간 - `api.pl_id` (integer): API 결제 로그 ID ## API 요청: POST /rest/land_rt_price ### 입력 - `addr1` (string, 필수): 도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시) - `addr2` (string, 필수): 시/군/구 (예: 금천구) - `type` (string, 필수): 유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등 - `year` (string, 필수): 조회 년도 (1950 ~ 현재 년도, 예: 2025) ### 응답 명세 ```json { "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 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "result": 1, "data": [ { "NO": "1", "시군구": "서울특별시 금천구 시흥동", "번지": "111", "본번": "0111", "부번": "0000", "단지명": "OO", "전용면적(㎡)": "59.6800", "계약년월": "202501", "계약일": "01", "거래금액(만원)": "99,999", "동": "-", "층": "2", "매수자": "개인", "매도자": "개인", "건축년도": "2000", "도로명": "OO대로OO길 OO", "해제사유발생일": "-", "거래유형": "직거래", "중개사소재지": "-", "등기일자": "25.01.07" }, { "NO": "2", "시군구": "서울특별시 금천구 시흥동", "번지": "1010", "본번": "1010", "부번": "0000", "단지명": "OO", "전용면적(㎡)": "84.9900", "계약년월": "202501", "계약일": "01", "거래금액(만원)": "99,999", "동": "-", "층": "15", "매수자": "개인", "매도자": "개인", "건축년도": "2000", "도로명": "OO로 OOO", "해제사유발생일": "-", "거래유형": "중개거래", "중개사소재지": "서울 금천구", "등기일자": "-" }, { "NO": "3", "시군구": "서울특별시 금천구 가산동", "번지": "222-22", "본번": "0222", "부번": "0022", "단지명": "OO5차", "전용면적(㎡)": "62.5300", "계약년월": "202501", "계약일": "01", "거래금액(만원)": "99,900", "동": "-", "층": "3", "매수자": "개인", "매도자": "개인", "건축년도": "2001", "도로명": "OO로OO길 OO", "해제사유발생일": "-", "거래유형": "중개거래", "중개사소재지": "서울 금천구", "등기일자": "-" }, { "NO": "4", "시군구": "서울특별시 금천구 독산동", "번지": "5555", "본번": "5555", "부번": "0000", "단지명": "금천OOOOOOOO3차", "전용면적(㎡)": "59.9672", "계약년월": "202501", "계약일": "04", "거래금액(만원)": "99,000", "동": "-", "층": "14", "매수자": "개인", "매도자": "개인", "건축년도": "2018", "도로명": "OO대로 OOO", "해제사유발생일": "-", "거래유형": "중개거래", "중개사소재지": "서울 금천구", "등기일자": "-" } ], "count": 4, "success": 1 }, "api": { "success": true, "cost": 100, "ms": 390, "pl_id": 4135 } } ``` ### 정적 응답 예시 ```json { "data": { "msg": "[addr2] 입력 항목이 잘못됐습니다.", "result": 0, "options": [ "강남구", "강동구", "강북구", "강서구", "관악구", "광진구", "구로구", "금천구", "노원구", "도봉구", "동대문구", "동작구", "마포구", "서대문구", "서초구", "성동구", "성북구", "송파구", "양천구", "영등포구", "용산구", "은평구", "종로구", "중구", "중랑구" ], "success": 1 }, "api": { "success": true, "cost": 100, "ms": 240, "pl_id": 4134 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/land_rt_price' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'addr1=서울특별시' \ --form-string 'addr2=금천구' \ --form-string 'type=A' \ --form-string 'year=2025' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("addr1", "서울특별시"); form.append("addr2", "금천구"); form.append("type", "A"); form.append("year", "2025"); const response = await fetch("https://apick.app/rest/land_rt_price", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("addr1", (None, "서울특별시")), ("addr2", (None, "금천구")), ("type", (None, "A")), ("year", (None, "2025")), ] response = requests.request("POST", "https://apick.app/rest/land_rt_price", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php '서울특별시', 'addr2' => '금천구', 'type' => 'A', 'year' => '2025', ]; $curl = curl_init('https://apick.app/rest/land_rt_price'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 해당 년도에 실제 거래된 내역을 조회합니다. Method URL POST https://apick.app/rest/land_rt_price addr1에 유효하지 않은 시,도 등을 입력 시 "입력항목이 잘못됐습니다."라는 메시지와 함께 options 으로 유효한 목록이 응답됩니다. addr2에 유효하지 않은 시,군,구 등을 입력 시 "입력항목이 잘못됐습니다."라는 메시지와 함께 options 으로 유효한 목록이 응답됩니다. ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터 result Integer 검색 결과 0: 유효하지 않은 시, 도 등 입력 시(options와 함께 응답) 1: 성공 2: 오류(에이픽 서버 오류)(해당 오류 발생 시 요청 내용과 함께 문의글로 남겨주시기 바랍니다.) 3: 오류(처리시간 초과) msg String 메시지 내용 (result가 0인 경우 반환) error String 오류 내용 (result가 2,3인 경우 반환) options Array result가 0인 경우 입력 가능한 값 목록 data Array 실거래 목록 {} Object 거래 정보 NO String NO 시군구 String 시군구 번지 String 번지 본번 String 본번 부번 String 부번 단지명 String 단지명 전용면적(㎡) String 전용면적(㎡) 계약년월 String 계약년월 계약일 String 계약일 거래금액(만원) String 거래금액(만원) 동 String 동 층 String 층 매수자 String 매수자 매도자 String 매도자 건축년도 String 건축년도 도로명 String 도로명 주소 해제사유발생일 String 해제사유발생일 거래유형 String 거래유형 중개사소재지 String 중개사소재지 등기일자 String 등기일자 count Integer 조회된 총 개수 success Integer 과금 여부0: 실패1: 성공3: 실패(timeout) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 예시 1 예시 2 form-data 전체 예제 보기 form-data 전체 예제 보기 응답 예시 예시 1 예시 2 { "data": { "result": 1, "data": [ { "NO": "1", "시군구": "서울특별시 금천구 시흥동", "번지": "111", "본번": "0111", "부번": "0000", "단지명": "OO", "전용면적(㎡)": "59.6800", "계약년월": "202501", "계약일": "01", "거래금액(만원)": "99,999", "동": "-", "층": "2", "매수자": "개인", "매도자": "개인", "건축년도": "2000", "도로명": "OO대로OO길 OO", "해제사유발생일": "-", "거래유형": "직거래", "중개사소재지": "-", "등기일자": "25.01.07" }, { "NO": "2", "시군구": "서울특별시 금천구 시흥동", "번지": "1010", "본번": "1010", "부번": "0000", "단지명": "OO", "전용면적(㎡)": "84.9900", "계약년월": "202501", "계약일": "01", "거래금액(만원)": "99,999", "동": "-", "층": "15", "매수자": "개인", "매도자": "개인", "건축년도": "2000", "도로명": "OO로 OOO", "해제사유발생일": "-", "거래유형": "중개거래", "중개사소재지": "서울 금천구", "등기일자": "-" }, { "NO": "3", "시군구": "서울특별시 금천구 가산동", "번지": "222-22", "본번": "0222", "부번": "0022", "단지명": "OO5차", "전용면적(㎡)": "62.5300", "계약년월": "202501", "계약일": "01", "거래금액(만원)": "99,900", "동": "-", "층": "3", "매수자": "개인", "매도자": "개인", "건축년도": "2001", "도로명": "OO로OO길 OO", "해제사유발생일": "-", "거래유형": "중개거래", "중개사소재지": "서울 금천구", "등기일자": "-" }, { "NO": "4", "시군구": "서울특별시 금천구 독산동", "번지": "5555", "본번": "5555", "부번": "0000", "단지명": "금천OOOOOOOO3차", "전용면적(㎡)": "59.9672", "계약년월": "202501", "계약일": "04", "거래금액(만원)": "99,000", "동": "-", "층": "14", "매수자": "개인", "매도자": "개인", "건축년도": "2018", "도로명": "OO대로 OOO", "해제사유발생일": "-", "거래유형": "중개거래", "중개사소재지": "서울 금천구", "등기일자": "-" } ], "count": 4, "success": 1 }, "api": { "success": true, "cost": 100, "ms": 390, "pl_id": 4135 } } { "data": { "msg": "[addr2] 입력 항목이 잘못됐습니다.", "result": 0, "options": [ "강남구", "강동구", "강북구", "강서구", "관악구", "광진구", "구로구", "금천구", "노원구", "도봉구", "동대문구", "동작구", "마포구", "서대문구", "서초구", "성동구", "성북구", "송파구", "양천구", "영등포구", "용산구", "은평구", "종로구", "중구", "중랑구" ], "success": 1 }, "api": { "success": true, "cost": 100, "ms": 240, "pl_id": 4134 } }