빌라 이름에 검색 키워드가 포함된 건물 목록을 반환하는 API입니다. 건물명에 해당하는 지번주소, 도로명주소 등의 정보를 제공합니다.
이름 | 설명 | 예 | 필수 |
---|---|---|---|
siindex | 시코드 | 1 | O |
buildingname | 건물명 | 청운 | O |
속성 | 설명 | 비고 |
---|---|---|
RETURN_CODE | 요청결과값 |
0000 : 정상 2000 : 파라미터 오류 3000 : 인증오류 4000 : 결과없음 9999 : 서버오류 |
RETURN_MSG | 응답메시지 | |
DATA | 데이터 루트 | 데이터 시작 속성 |
속성 | 설명 | 비고 |
---|---|---|
BUILDING_LIST | 건물 리스트 루트 | |
BUILDING | 건물 루트 | |
NAME | 건물명 | |
ADDRESS | 지번주소 | |
DOROADDRESS | 도로명주소 | |
SREG | 구코드 | |
SEUB | 동코드 | |
BUNJI1 | 본번 | |
BUNJI2 | 부번 | (부번 없을시 기본값 0) |
<!-- 결과가 여러 개일 경우, BUILDING 리턴값 여러 개 출력됨. 일치하는 내용 없을 시 BULDING 리턴 없음 --> <LOBIG> <RETURN_CODE>0000</RETURN_CODE> <RETURN_MSG>정상</RETURN_MSG> <DATA> <BUILDING_LIST> <BUILDING> <NAME>청운벽산빌리지</NAME> <ADDRESS>서울특별시 종로구 청운동 1번지</ADDRESS> <DOROADDRESS>서울특별시 종로구 자하문로36길 16-14</DOROADDRESS> <SREG>11110</SREG> <SEUB>10100</SEUB> <BUNJI1>1</BUNJI1> <BUNJI2>0</BUNJI2> </BUILDING> <BUILDING> <NAME>청운벽산빌리지1</NAME> <ADDRESS>서울특별시 종로구 청운동 2번지</ADDRESS> <DOROADDRESS>서울특별시 종로구 자하문로36길 16-15</DOROADDRESS> <SREG>11110</SREG> <SEUB>10100</SEUB> <BUNJI1>2</BUNJI1> <BUNJI2>0</BUNJI2> </BUILDING> ... <BUILDING> <NAME>청운벽산빌리지2</NAME> <ADDRESS>서울특별시 종로구 청운동 3번지</ADDRESS> <DOROADDRESS>서울특별시 종로구 자하문로36길 16-16</DOROADDRESS> <SREG>11110</SREG> <SEUB>10100</SEUB> <BUNJI1>3</BUNJI1> <BUNJI2>0</BUNJI2> </BUILDING> </BUILDING_LIST> </DATA> </LOBIG>
선택된 건물, 혹은 동에 대한 상세 정보를 제공하는 API 입니다. 원하는 건물의 면적, 용도, 세대 수, 주차장 수, 사용승인일 등 건축물의 주요 특성 정보를 제공합니다.
이름 | 설명 | 예 | 필수 |
---|---|---|---|
siindex | 시코드 | 1 | O |
sreg | 구코드 | 11110 | O |
seub | 동코드 | 10100 | O |
bunji1 | 본번 | 1 | O |
bunji2 | 부번 | 0 | (부번 없을시 기본값 0) |
dong | 건물 동이름 | 9동 | O (동이름 없을 시 기본값 0000) |
속성 | 설명 | 비고 |
---|---|---|
RETURN_CODE | 요청결과값 |
0000 : 정상 2000 : 파라미터 오류 3000 : 인증오류 4000 : 결과없음 9999 : 서버오류 |
RETURN_MSG | 응답메시지 | |
DATA | 데이터 루트 | 데이터 시작 속성 |
속성 | 설명 | 비고 |
---|---|---|
DONGNAME | 동이름 | 동이름이 없을 시 빈 문자열 |
MAIN_USE | 주용도 | |
SUB_USE | 부용도 | |
LAT | 위도 | |
LNG | 경도 | |
ANTI_GROUND_AREA | 대지면적 | |
ANTI_GROUND_AREA_STEP | 대지면적 클린징 성공 실패 코드 | |
BUILD_AREA | 건축면적 | |
BUILD_COVERAGE_RATIO | 건폐율 | |
GF_AREA | 연면적 | |
GROUND_GF_AREA | 지상연면적(용적률산정연면적) | |
GROUND_GF_AREA_STEP | 지상연면적(용적률산정연면적) 클린징 성공 실패 코드 | |
FLOOR_AREA_RATIO | 용적률 | |
HEIGHT | 높이 | |
TOTAL_GROUND_FLOOR | 지상층수 | |
TOTAL_UNDERGROUND_FLOOR | 지하층수 | |
HOUSEHOLDS | 세대수 | |
PARKING_CNT | 주차장 수 | |
HOUSEHOLD_PARKING_CNT | 세대당 주차장 수 | 주차장 수/세대 수 |
HAVE_ELEVATOR | 엘리베이터 유무 | 0: 없음 1: 있음 |
USEAUTH_DATE | 사용승인일 | |
ZONING_DISTRICT | 지역지구 |
<LOBIG> <script/> <RETURN_CODE>0000</RETURN_CODE> <RETURN_MSG>정상</RETURN_MSG> <DATA> <DONGNAME/> <MAIN_USE>공동주택</MAIN_USE> <SUB_USE>다세대주택</SUB_USE> <LAT>127.117</LAT> <LNG>37.5066</LNG> <ANTI_GROUND_AREA>357</ANTI_GROUND_AREA> <ANTI_GROUND_AREA_STEP>1-1</ANTI_GROUND_AREA_STEP> <BUILD_AREA>191.4</BUILD_AREA> <BUILD_COVERAGE_RATIO>53.61</BUILD_COVERAGE_RATIO> <GF_AREA>659.28</GF_AREA> <GROUND_GF_AREA>659.28</GROUND_GF_AREA> <GROUND_GF_AREA_STEP>1-1</GROUND_GF_AREA_STEP> <FLOOR_AREA_RATIO>184.67</FLOOR_AREA_RATIO> <HEIGHT>14.6</HEIGHT> <TOTAL_GROUND_FLOOR>5</TOTAL_GROUND_FLOOR> <TOTAL_UNDERGROUND_FLOOR>0</TOTAL_UNDERGROUND_FLOOR> <HOUSEHOLDS>8</HOUSEHOLDS> <PARKING_CNT>8</PARKING_CNT> <HOUSEHOLD_PARKING_CNT>1</HOUSEHOLD_PARKING_CNT> <USEAUTH_DATE>20080519</USEAUTH_DATE> <ZONING_DISTRICT>도시지역</ZONING_DISTRICT> </DATA> </LOBIG>
층별 주용도 코드값, 표제부(총괄표제부)구조, 표제부(총괄표제부) 지붕구조 코드를 출력하는 API입니다. 원하는 주소에 해당하는 건축물의 층 구성 및 호 구성 정보와 각 호별 시세제공 여부 정보를 제공합니다
이름 | 설명 | 예 | 필수 |
---|---|---|---|
siindex | 시코드 | 1 | O |
sreg | 구코드 | 11110 | O |
seub | 동코드 | 10100 | O |
bunji1 | 본번 | 1 | O |
bunji2 | 부번 | 0 | O (부번 없을시 기본값 0) |
속성 | 설명 | 비고 |
---|---|---|
RETURN_CODE | 요청결과값 |
0000 : 정상 2000 : 파라미터 오류 3000 : 인증오류 4000 : 결과없음 9999 : 서버오류 |
RETURN_MSG | 응답메시지 | |
DATA | 데이터 루트 | 데이터 시작 속성 |
속성 | 설명 | 비고 |
---|---|---|
DONG_LIST | 동 리스트 루트 | 동이름이 없을 시 빈 문자열 |
DONG | 동 루트 | |
DONGNAME | 건물 동 이름 | |
STRUCTURE_CODE | 건축물 구조 코드 | |
STRUCTURE_NAME | 건축물 구조명 | |
TRUCTURE_ROOF_CODE | 지붕 구조 코드 | |
STRUCTURE_ROOF_NAME | 지붕 구조명 | |
FLOOR_LIST | 층 리스트 루트 | |
FLOOR | 층 루트 | |
FLOOR_GUBUN_NAME | 층 구분 코드명 | |
FLOOR_NUMBER | 층 번호 | |
GAEYO_COUNT | 해당 층의 층별개요 정보 수 | |
GAEYO_LIST | 층별개요 리스트 루트 | |
GAEYO | 층별개요 루트 | |
MAINUSE_CODE | 층별개요 주 용도 코드 | |
MAINUSE_NAME | 층별개요 주 용도 코드명 | |
AREA | 면적 | |
HO_LIST | 호 리스트 루트 | |
HO | 호 루트 | |
DONG_NAME | 동 이름 | |
FLOOR_NUMBER | 층 번호 | |
HO_NAME | 호이름 | |
MAINUSE_CODE | 주용도 코드값 | |
HAVE_SISE | 시세 제공 여부 | 0: 없음 1: 있음 |
<LOBIG> <RETURN_CODE>0000</RETURN_CODE> <RETURN_MSG>정상</RETURN_MSG> <DATA> <DONG_LIST> <DONG><!-- 동이 여러개 일 경우도 있음 --> <DONGNAME>나동</DONGNAME><!-- 동 이름은 없을 수도 있음 --> <STRUCTURE_CODE>11</STRUCTURE_CODE> <STRUCTURE_NAME>벽돌구조</STRUCTURE_NAME> <STRUCTURE_ROOF_CODE>10</STRUCTURE_ROOF_CODE> <STRUCTURE_ROOF_NAME>(철근)콘크리트</STRUCTURE_ROOF_NAME> <FLOOR_LIST> <FLOOR_LIST> <FLOOR> <FLOOR_GUBUN_NAME>지하</FLOOR_GUBUN_NAME> <FLOOR_NUMBER>1</FLOOR_NUMBER> <GAEYO_COUNT>1</GAEYO_COUNT> <GAEYO_LIST><!-- 한 층에 여러개의 개요가 있을 수도 있음 --> <GAEYO> <MAINUSE_CODE>02003</MAINUSE_CODE> <MAINUSE_NAME>다세대주택</MAINUSE_NAME> <AREA>82.92</AREA> </GAEYO> </GAEYO_LIST> <HO_LIST><!-- 해당 층에 속하는 호 정보 / 없을 수도 있음 --> <HO> <DONG_NAME>나동</DONG_NAME> <FLOOR_NUMBER>1</FLOOR_NUMBER> <HO_NAME>지층1호</HO_NAME> <MAINUSE_CODE>02003</MAINUSE_CODE> <HAVE_SISE>0</HAVE_SISE> </HO> <HO> <DONG_NAME>나동</DONG_NAME> <FLOOR_NUMBER>1</FLOOR_NUMBER> <HO_NAME>지층2호</HO_NAME> <MAINUSE_CODE>02003</MAINUSE_CODE> <HAVE_SISE>0</HAVE_SISE> </HO> </HO_LIST> <!-- 해당 층에 호가 없을 수도 있음 --> </FLOOR> ... </FLOOR_LIST> </DONG> ... </DONG_LIST> </DATA> </LOBIG>
요청한 호의 기본 정보(시세, 클린징 면적 등)을 제공하는 API입니다. 원하는 건물의 호에 대한 시세 및 전용면적, 대지권 면적 등 호에 대한 상세 정보를 제공 합니다.
이름 | 설명 | 예 | 필수 |
---|---|---|---|
siindex | 시코드 | 1 | O |
sreg | 구코드 | 11110 | O |
seub | 동코드 | 10100 | O |
bunji1 | 본번 | 1 | O |
bunji2 | 부번 | 0 | O (부번 없을시 기본값 0) |
dong | 건물 동이름 | 9동 | O (동이름 없을 시 기본값 0000) |
floor | 층번호 | 10 | O (층번호 없을 시, 기본값 0) |
ho | 호 | 101호 | O |
속성 | 설명 | 비고 |
---|---|---|
RETURN_CODE | 요청결과값 |
0000 : 정상 2000 : 파라미터 오류 3000 : 인증오류 4000 : 결과없음 9999 : 서버오류 |
RETURN_MSG | 응답메시지 | |
DATA | 데이터 루트 | 데이터 시작 속성 |
속성 | 설명 | 비고 |
---|---|---|
ADDRESS | 지번 주소 | 동이름이 없을 시 빈 문자열 |
DONG | 동이름 | 동 |
NAME | 주택명 | 호 |
AVER_SISE | 평균 시세 | 단위 : 천원 |
AVER_SISE_PER_AREA | 면적 당 시세(1㎡ 당 시세) | 단위 : 천원/㎡ |
AVER_COUNT | 거래 사례수 | |
TOTAL_PRIVATE_AREA | 전용면적 총합 | |
TOTAL_PUBLIC_AREA | 공용면적 총합 | |
PRIVATE_AREA_LIST | 전용면적 정보 리스트 루트 | |
PRIVATE_AREA | 전용면적 정보 루트 | |
USAGE | 용도 | |
AREA | 면적 | |
FLOOR | 층 | |
PUBLIC_AREA_LIST | 공용면적 정보 리스트 루트 | |
PUBLIC_AREA | 공용면적 정보 루트 | |
USAGE | 용도 | |
AREA | 면적 | |
FLOOR | 층 | |
ANTI_GROUND_SHARE_AREA | 대지권 면적 | |
ANTI_GROUND_RATIO_STEP | 대지권 비율 클린징 코드 |
<LOBIG> <RETURN_CODE>0000</RETURN_CODE> <RETURN_MSG>정상</RETURN_MSG> <DATA> <ADDRESSS>서울특별시 서대문구 남가좌동 104-16번지</ADDRESS> <DONG>1동</DONG> <NAME>201호</NAME> <AVER_SISE>31600</AVER_SISE> <AVER_SISE_PER_AREA>1940</AVER_SISE_PER_AREA> <AVER_COUNT>149</AVER_COUNT> <TOTAL_PRIVATE_AREA>21.32</TOTAL_PRIVATE_AREA> <TOTAL_PUBLIC_AREA>21.32</TOTAL_PUBLIC_AREA> <PRIVATE_AREA_LIST> <PRIVATE_AREA><!-- 여러 개 있을 수 있음 --> <USAGE>부대시설/지하실</USAGE> <AREA>10.32</AREA> <FLOOR>지하1층</FLOOR> </PRIVATE_AREA> <PRIVATE_AREA> <USAGE>연립주택/연립주택</USAGE> <AREA>11</AREA> <FLOOR>2층</FLOOR> </PRIVATE_AREA> ... </PRIVATE_AREA_LIST> <PUBLIC_AREA_LIST> <PUBLIC_AREA><!-- 여러 개 있을 수 있음 --> <USAGE>부대시설/지하실</USAGE> <AREA>10.32</AREA> <FLOOR>지하1층</FLOOR> </PUBLIC_AREA> <PUBLIC_AREA> <USAGE>연립주택/연립주택</USAGE> <AREA>11</AREA> <FLOOR>1층</FLOOR> </PUBLIC_AREA> ... </PUBLIC_AREA_LIST> <ANTI_GROUND_SHARE_AREA>13.28</ANTI_GROUND_AREA> <ANTI_GROUND_RATIO_STEP>1-1</ANTI_GROUND_RATIO_STEP> </DATA> </LOBIG>