국토교통부_마이홈포털 공공주택 모집공고 조회 서비스

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

PNU item 결과메세지 결과코드 공고ID 공고명 공급_기관명 공급_호_수 (전세임대 해당) 공급_호수 공급유형명 광역시도명 난방_방식명 단지_명 당첨자_발표_일자 도로명 (주소가 도로명주소일 때 표시) 마이홈포털 Mobile URL 마이홈포털 PC URL 모집 시작 일자 모집 종료 일자 모집_공고_일자 모집공고 URL 문의처 상태_명 시군구명 이전_공고_ID 전체 결과수 전체주소 조회될 목록의 페이지당 데이터 개수 (기본값:10) 조회될 페이지의 번호 (기본값:1) 주택 일련번호 주택유형_명 참조_법정동명 (주소가 지번주소일 때 표시) 총_세대_수 최소_계약금 최소_월_임대료 최소_임대_보증금 최소_잔금 최소_중도금

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '공급유형=값' \
  --data-urlencode '광역시도 코드=11110' \
  --data-urlencode '시군구 코드=11110' \
  --data-urlencode '월임대료 구분=01' \
  --data-urlencode '전세형 모집 여부=값'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "공공데이터포털에서 받은 인증키": "값",
  "공급유형": "값",
  "광역시도 코드": "11110",
  "시군구 코드": "11110",
  "월임대료 구분": "01",
  "전세형 모집 여부": "값",
});

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",
    "월임대료 구분": "01",
    "전세형 모집 여부": "값",
}

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