개발가이드

  • 개발가이드

부동산 정보 조회

부동산 소유자, 토지소유자, 공시지가, 주택가격 등 정보를 조회합니다.

부동산 정보 조회 서비스는 다음과 같은 정보가 제공됩니다. ◼ 소재지 ◼ 건물명, 동, 호 ◼ 건물 소유자 ◼ 토지이용계획 ◼ 토지 소유권 변경 이력 ◼ 공시지가 ◼ 주택가격

정보

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

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
addr1
String
O
도,광역시,특별시
(아래 항목중 선택)
◼ 서울특별시
◼ 부산광역시
◼ 대구광역시
◼ 인천광역시
◼ 광주광역시
◼ 대전광역시
◼ 울산광역시
◼ 세종특별자치시
◼ 경기도
◼ 충청북도
◼ 충청남도
◼ 전라남도
◼ 경상북도
◼ 경상남도
◼ 제주특별자치도
◼ 강원특별자치
◼ 전북특별자치도
addr2
String
O
시, 군, 구
addr3
String
O
읍, 면, 동
addr4
String
X
리
선택지가 1개일 경우 무시하고 해당 선택지 적용됩니다.
선택지 없는 경우 무시됩니다.
"error" 필드에 "addr4 값을 선택해 주세요." 응답시 필수 입력해야 됩니다.
선택지가 궁금하신 경우 "?" 입력시 "options" 필드를 통해 선택지를 확인하실 수 있습니다.
addr5
String
O
지번 앞자리
(양의 정수만 허용)
addr6
String
X
지번 뒷자리
(양의 정수만 허용)
지번 뒷자리가 없는 경우 비워두셔야 합니다.
addr7
String
X
건물
선택지가 1개일 경우 입력 값을 무시하고 해당 선택지 적용됩니다.
선택지 없는 경우 무시됩니다.
선택지가 궁금하신 경우 "?" 입력시 "options" 필드를 통해 선택지를 확인하실 수 있습니다.
값 미입력시 토지에 대한 정보만 제공됩니다.
addr8
String
X
호수
addr8 값 입력시 addr7 값 입력은 필수입니다.
선택지가 1개일 경우 입력 값을 무시하고 해당 선택지 적용됩니다.
선택지 없는 경우 무시됩니다.
선택지가 궁금하신 경우 "?" 입력시 "options" 필드를 통해 선택지를 확인하실 수 있습니다.
값 미입력시 건물, 토지에 대한 정보만 제공됩니다.
type
String
O
기본값 : 토지
(아래 항목중 선택)
◼ 토지
◼ 임야
◼ 토지(폐쇄)
◼ 임야(폐쇄)
선택지 옵션이 궁금할 경우 "?" 값을 넣으면 응답 필드 "options"를 통해 선택지를 확인하실 수 있습니다. 최종 결과물을 응답할 경우에만 과금됩니다. 선택지 확인 요청은 과금되지 않습니다.

응답

Body
이름
타입
설명
data
Object
조회 데이터
ic_id
Integer
요청 ID
result
Integer
검색 결과
0: 옵션이 존재하는 경우
(정해진 값 이외의 값을 입력하거나 ? 검색 시)
1: 성공
2: 오류(에이픽 서버 오류)
(해당 오류 발생 시 ic_id와 함께 문의글로 남겨주시기 바랍니다.)
3: 오류(처리시간 초과)
msg
String
메시지 내용
(result가 0인 경우 반환)
error
String
오류 내용
(result가 2,3인 경우 반환)
options
Array
result가 0인 경우 입력 가능한 값 목록
data
Object
부동산 조회 정보
소재지
String
소재지
건물명
String
건물명
유형
String
유형
동
String
동
호
String
호
소유자
String
소유자
기준시점
String
기준시점
토지이용계획_1
String
토지이용계획_1
토지이용계획_2
String
토지이용계획_2
토지이용계획_3
String
토지이용계획_3
토지이용계획_4
String
토지이용계획_4
토지소유권변경이력
Array
토지소유권변경이력
{}
Object
순번
String
순번
변동일자
String
변동일자
변동원인
String
변동원인
성명
String
성명
번호
String
번호
기관
String
기관
(개인 또는 법인)
주소
String
주소
공시지가
Array
공시지가
{}
Object
기준일자
String
기준일자
가격
String
가격
주택가격
Array
주택가격
{}
Object
기준일자
String
기준일자
가격
String
가격
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
  • 예시 3

curl -k -X POST "https://apick.app/rest/land_info/" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "addr1=서울특별시" \
-F "addr2=금천구" \
-F "addr3=가산동" \
-F "addr5=550" \
-F "addr6=9" \
-F "addr7=(집합)에이스 가산타워" \
-F "type=토지"
            

curl -k -X POST "https://apick.app/rest/land_info/" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "addr1=경기도" \
-F "addr2=가평군" \
-F "addr3=가평읍" \
-F "addr4=?" \
-F "addr5=213" \
-F "type=토지"
            

curl -k -X POST "https://apick.app/rest/land_info/" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "addr1=서울특별시" \
-F "addr2=금천구" \
-F "addr3=가산동" \
-F "addr5=60" \
-F "addr6=26" \
-F "addr7=?" \
-F "type=토지"
응답 예시
  • 예시 1
  • 예시 2
  • 예시 3

{
    "data": {
        "ic_id": 3174795,
        "result": 1,
        "data": {
            "소재지": "서울특별시 금천구 가산동  550-9 (서울특별시 금천구 디지털로 121 (가산동))",
            "건물명": "에이스 가산타워",
            "유형": "",
            "동": "",
            "호": "",
            "소유자": "",
            "기준시점": "202411172117",
            "토지이용계획_1": "도시지역, 준공업지역, 지구단위계획구역(2021-10-28), 도로(접합), 중로1류(폭 20m~25m)(2021-10-28)(접합), 일단의공업용지조성사업지역",
            "토지이용계획_2": "가축사육제한구역<가축분뇨의 관리 및 이용에 관한 법률>, 가로구역별 최고높이 제한지역(2015-08-27)(서울특별시고시 제2015-255호)<건축법>, 장애물제한표면구역(진입표면구역)<공항시설법>, 대공방어협조구역(위탁고도:해발194m(지반+건축+옥탑 등),육군수도방위사령부(02-524-3313)관할)<군사기지 및 군사시설 보호법>, 국가산업단지(2012-07-05)<산업입지 및 개발에 관한 법률>, 산업시설구역<산업집적활성화 및 공장설립에 관한 법률>, 과밀억제권역<수도권정비계획법>, (한강)폐기물매립시설 설치제한지역<한강수계 상수원수질개선 및 주민지원 등에 관한 법률>",
            "토지이용계획_3": "",
            "토지이용계획_4": "",
            "토지소유권변경이력": [
                {
                    "순번": "1",
                    "변동일자": "2019.01.11",
                    "변동원인": "대지권설정",
                    "성명": "",
                    "번호": "",
                    "기관": "",
                    "주소": ""
                },
                {
                    "순번": "2",
                    "변동일자": "2016.11.10",
                    "변동원인": "소유권이전",
                    "성명": "주식회사◯◯◯◯◯◯◯",
                    "번호": "110111-2******",
                    "기관": "법인",
                    "주소": "서울특별시 강남구 ◯◯◯ ◯◯◯, ◯층(◯◯동,◯◯◯◯)"
                },
                {
                    "순번": "3",
                    "변동일자": "2016.11.10",
                    "변동원인": "소유권이전",
                    "성명": "주식회사◯◯◯◯◯",
                    "번호": "230111-0******",
                    "기관": "법인",
                    "주소": "서울특별시 금천구 ◯◯◯◯ ◯◯◯, ◯층 ◯◯◯호(◯◯동,◯◯◯◯◯)"
                },
                {
                    "순번": "4",
                    "변동일자": "2016.04.11",
                    "변동원인": "소유권이전",
                    "성명": "주식회사◯◯◯◯◯",
                    "번호": "110111-2******",
                    "기관": "법인",
                    "주소": "서울특별시 강남구 ◯◯◯◯ ◯◯◯,◯◯층(◯◯동,◯◯◯◯◯빌딩)"
                },
                {
                    "순번": "5",
                    "변동일자": "2016.04.11",
                    "변동원인": "소유권이전",
                    "성명": "주식회사◯◯◯◯◯",
                    "번호": "230111-0******",
                    "기관": "법인",
                    "주소": "서울특별시 금천구 ◯◯◯로 ◯◯◯,◯층◯◯◯호(◯◯동,◯◯◯◯◯)"
                },
                {
                    "순번": "6",
                    "변동일자": "2001.10.15",
                    "변동원인": "성명(명칭)변경",
                    "성명": "주식회사◯◯◯◯◯◯◯◯◯",
                    "번호": "110111-0******",
                    "기관": "법인",
                    "주소": "550-9"
                },
                {
                    "순번": "7",
                    "변동일자": "1995.05.11",
                    "변동원인": "주소변경",
                    "성명": "주식회사◯◯◯◯◯",
                    "번호": "110111-0******",
                    "기관": "법인",
                    "주소": "550-9"
                },
                {
                    "순번": "8",
                    "변동일자": "1985.12.28",
                    "변동원인": "성명(명칭)변경",
                    "성명": "주식회사◯◯◯◯◯",
                    "번호": "110111-0******",
                    "기관": "법인",
                    "주소": "가리봉동550-9"
                },
                {
                    "순번": "9",
                    "변동일자": "1974.10.31",
                    "변동원인": "주소변경",
                    "성명": "주식회사◯◯◯◯",
                    "번호": "110111-0******",
                    "기관": "법인",
                    "주소": "가리봉동550-9"
                }
            ],
            "공시지가": [
                {
                    "기준일자": "2024.01.01",
                    "가격": "5,033,000"
                },
                {
                    "기준일자": "2023.01.01",
                    "가격": "5,004,000"
                },
                {
                    "기준일자": "2022.01.01",
                    "가격": "5,267,000"
                },
                {
                    "기준일자": "2021.01.01",
                    "가격": "4,504,000"
                },
                {
                    "기준일자": "2020.01.01",
                    "가격": "3,958,000"
                },
                {
                    "기준일자": "2019.01.01",
                    "가격": "3,617,000"
                },
                {
                    "기준일자": "2018.01.01",
                    "가격": "3,426,000"
                },
                {
                    "기준일자": "2017.01.01",
                    "가격": "3,045,000"
                },
                {
                    "기준일자": "2016.01.01",
                    "가격": "2,881,000"
                },
                {
                    "기준일자": "2015.01.01",
                    "가격": "2,798,000"
                },
                {
                    "기준일자": "2014.01.01",
                    "가격": "2,701,000"
                },
                {
                    "기준일자": "2013.01.01",
                    "가격": "2,560,000"
                },
                {
                    "기준일자": "2012.01.01",
                    "가격": "2,440,000"
                },
                {
                    "기준일자": "2011.01.01",
                    "가격": "2,360,000"
                },
                {
                    "기준일자": "2010.01.01",
                    "가격": "2,300,000"
                },
                {
                    "기준일자": "2009.01.01",
                    "가격": "2,190,000"
                },
                {
                    "기준일자": "2008.01.01",
                    "가격": "2,130,000"
                },
                {
                    "기준일자": "2007.01.01",
                    "가격": "2,030,000"
                },
                {
                    "기준일자": "2006.01.01",
                    "가격": "1,830,000"
                },
                {
                    "기준일자": "2005.01.01",
                    "가격": "1,470,000"
                },
                {
                    "기준일자": "2004.01.01",
                    "가격": "1,330,000"
                },
                {
                    "기준일자": "2003.01.01",
                    "가격": "967,000"
                },
                {
                    "기준일자": "2002.01.01",
                    "가격": "800,000"
                }
            ],
            "주택가격": []
        },
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 500,
        "ms": 23072,
        "pl_id": 12393093
    }
}
            

{
    "data": {
        "msg": "addr4 값을 선택해주세요.",
        "type": 15,
        "result": 0,
        "options": [
            "개곡리",
            "경반리",
            "금대리",
            "달전리",
            "대곡리",
            "두밀리",
            "마장리",
            "복장리",
            "산유리",
            "상색리",
            "승안리",
            "읍내리",
            "이화리",
            "하색리"
        ],
        "success": 0
    },
    "api": {
        "cost": 0,
        "success": true,
        "ms": 3013
    }
}
            

{
    "data": {
        "msg": "addr7 값을 선택해주세요.",
        "type": 15,
        "result": 0,
        "options": [
            "(총괄)가산퍼블릭 ",
            "(집합)가산퍼블릭  A동",
            "(집합)가산퍼블릭  B동",
            "(집합)가산퍼블릭  C동"
        ],
        "success": 0
    },
    "api": {
        "cost": 0,
        "success": true,
        "ms": 10030
    }
}
현재 페이지 북마크