개발가이드

  • 개발가이드

부동산 실거래가 조회

부동산의 실제 거래이력을 조회합니다.

해당 년도에 실제 거래된 내역을 조회합니다.

정보

Method
URL
POST
https://apick.app/rest/land_rt_price

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
addr1
String
O
도,광역시,특별시
(아래 항목중 선택)
◼ 서울특별시
◼ 부산광역시
◼ 대구광역시
◼ 인천광역시
◼ 광주광역시
◼ 대전광역시
◼ 울산광역시
◼ 세종특별자치시
◼ 경기도
◼ 충청북도
◼ 충청남도
◼ 전라남도
◼ 경상북도
◼ 경상남도
◼ 제주특별자치도
◼ 강원특별자치도
◼ 전북특별자치도
addr2
String
O
시, 군, 구
type
String
O
유형(A~H 중 입력)
◼ A: 아파트
◼ B: 연립/다세대
◼ C: 단독/다가구
◼ D: 오피스텔
◼ E: 분양/입주권
◼ F: 상업/업무용
◼ G: 토지
◼ H: 공장/창고등
year
String
O
조회 년도
addr1에 유효하지 않은 시,도 등을 입력 시 "입력항목이 잘못됐습니다."라는 메시지와 함께 options 으로 유효한 목록이 응답됩니다. addr2에 유효하지 않은 시,군,구 등을 입력 시 "입력항목이 잘못됐습니다."라는 메시지와 함께 options 으로 유효한 목록이 응답됩니다.

응답

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

curl -k -X POST "https://apick.app/rest/land_rt_price/" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "addr1=서울특별시" \
-F "addr2=금천구" \
-F "type=A" \
-F "year=2025"
            

curl -k -X POST "https://apick.app/rest/land_rt_price/" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "addr1=서울특별시" \
-F "addr2=가산동" \
-F "type=A" \
-F "year=2025"
응답 예시
  • 예시 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
    }
}
현재 페이지 북마크