1. api 신청 방법

2. 제공 API 목록

2.1. 빌라명 검색

빌라 이름에 검색 키워드가 포함된 건물 목록을 반환하는 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>

2.2. 건축물 기본정보

선택된 건물, 혹은 동에 대한 상세 정보를 제공하는 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>

2.3. 호수 및 층수 배치도

층별 주용도 코드값, 표제부(총괄표제부)구조, 표제부(총괄표제부) 지붕구조 코드를 출력하는 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>

2.4. 호별 기본 정보

요청한 호의 기본 정보(시세, 클린징 면적 등)을 제공하는 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>