국토교통부_마이홈포털 공공임대주택 단지정보 조회 서비스

국토교통부에서 제공하는 마이홈포털 공공임대주택 단지정보 조회 서비스입니다. 오퍼레이션 파라미터를 기준으로 공공임대주택 단지정보 조회하는 서비스 (유의)조회하는 시점에 따라 ‘응답 메시지’가 달라질 수 있습니다. API는 활용신청을 통해 받은 인증키를 사용하여 접속할 수 있습니다. 데이터는 시도 등의 지역 정보를 포함하고 있으며, 공공임대주택 정보를 제공하고 있습니다. 공공임대주택으로는 국민임대, 영구임대, 행복주택 등의 유형을 구분하여 제공중입니다. 자세한 파라미터는 참고문서 파일을 참고해주십시오.

body header item pnu 건물 형태 결과메세지 결과코드 공급 공용 면적 공급 유형 명 공급 전용 면적 광역시도 명 광역시도 코드 기관 명 기본 월임대료 기본 임대보증금 기본 전환보증금 난방 방식 단지 명 단지 식별자 도로명 주소 세대 수 승강기 설치여부 시군구 명 시군구 코드 전체 결과수 주차수 주택 유형 명 준공 일자 페이지 번호 페이지당 데이터 개수 형 명

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '광역시도 코드=11110' \
  --data-urlencode '시군구 코드=11110' \
  --data-urlencode '조회될 목록의 페이지당 데이터 개수 (기본값:10)=1' \
  --data-urlencode '조회될 페이지의 번호 (기본값:1)=1'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "공공데이터포털에서 받은 인증키": "값",
  "광역시도 코드": "11110",
  "시군구 코드": "11110",
  "조회될 목록의 페이지당 데이터 개수 (기본값:10)": "1",
  "조회될 페이지의 번호 (기본값:1)": "1",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "공공데이터포털에서 받은 인증키": "값",
    "광역시도 코드": "11110",
    "시군구 코드": "11110",
    "조회될 목록의 페이지당 데이터 개수 (기본값:10)": "1",
    "조회될 페이지의 번호 (기본값:1)": "1",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())