AI 크롤러 · 수집 기록

봇별 요약 · 최근 24시간
← 카탈로그 목록
국토교통부

국토교통부 공동주택 기본 정보제공 서비스

국토교통부 공식 공동주택(K-apt 가입 단지) 기본·상세정보. 인증키 없이 GET /api/apt?kaptCode=A... 로 바로 호출(단지코드 필수, detail=1이면 상세정보). 서버에 data.go.kr 인증키 등록 완료 — 바로 호출 가능. 단지명·법정동/도로명주소·분양형태·난방방식·동수·세대수·시공사·관리방식·승강기·주차·CCTV·교통/편의시설까지 제공한다.

⚡ 공동주택 기본·상세정보 간편 호출

GET /api/apt?kaptCode=A10025972&detail=0

단지정보가 필요하면 이 주소를 먼저 사용. 인증키 불필요, kaptCode(단지코드) 필수, detail=1이면 상세정보. 서버 키 등록 완료 — 바로 호출 가능.

에이전트가 얻을 수 있는 정보

  • 단지명(kaptName), 법정동주소·도로명주소·법정동코드, 분양형태·난방방식·관리방식·복도유형, 동수·세대수·호수·연면적·최고층수, 시공사·시행사, 관리사무소 연락처·팩스·홈페이지, 사용승인일, 전용면적별 세대현황, 승강기·주차(지상/지하)·CCTV·전기차충전, 버스/지하철 접근성, 편의·교육시설, 부대복리시설
    단지 기본정보 조회, 관리방식·편의시설 확인, 실거래가(rtms-apt-trade)와 결합한 단지 분석, 이사·투자 의사결정 지원

활용 사례

  • 단지코드로 아파트 기본정보 조회
  • 관리방식·관리인원·계약업체 확인
  • 주차·승강기·CCTV·편의시설 현황 파악
  • 실거래가와 결합한 단지별 시세 분석

등록 API (2)

공동주택 기본 정보조회 getAphusBassInfoV5

단지코드로 31개 기본항목 조회. 존재하지 않는 단지코드는 resultCode 00 + 전 필드 null로 응답 → kaptCode null이면 자료없음으로 처리

  • kaptCode 필수 — 단지코드 (K-apt 단지코드, A+숫자) 예: A10025972
  • numOfRows 옵션 예: 10
  • pageNo 옵션 예: 1
  • dataType 옵션 예: JSON

출력: kaptCode/kaptName(단지코드/단지명), kaptAddr(법정동주소), doroJuso(도로명주소), bjdCode(법정동코드), codeSaleNm(분양형태), codeHeatNm(난방방식), codeMgrNm(관리방식), codeHallNm(복도유형), kaptDongCnt(동수), kaptdaCnt(세대수), hoCnt(호수), kaptTarea(연면적), kaptBcompany(시공사), kaptAcompany(시행사), kaptTel/kaptFax(관리사무소 연락처/팩스), kaptUrl(홈페이지), kaptUsedate(사용승인일), kaptTopFloor(최고층수), kaptMparea60/85/135/136(전용면적별 세대현황), privArea(단지 전용면적합)

호출 한도: 일 1,000회 (data.go.kr 일일 1,000회)

공동주택 상세 정보조회 getAphusDtlInfoV5

관리방식·설비·교통/편의시설 36개 항목. 타입 주의: 일부 숫자 항목이 문자열로 올 수 있음. 최고층수는 kaptTopFloor와 ktownFlrNo(건축물대장) 2종

  • kaptCode 필수 — 단지코드 (K-apt 단지코드, A+숫자) 예: A10025972
  • numOfRows 옵션 예: 10
  • pageNo 옵션 예: 1
  • dataType 옵션 예: JSON

출력: codeMgr/kaptMgrCnt/kaptCcompany(일반관리 방식·인원·계약업체), codeSec/kaptdScnt/kaptdSecCom(경비관리 방식·인원·계약업체), codeClean/kaptdClcnt(청소관리), codeGarbage(음식물처리), codeDisinf(소독관리), codeStr(건물구조), codeEcon(세대전기계약방식), codeWsupply(급수방식), kaptdEcnt(승강기), kaptdPcnt/지하주차, kaptdCccnt(CCTV), 지상/지하 전기차충전대수, kaptdWtimebus(버스정류장 거리), subwayLine/subwayStation(지하철), convenientFacility(편의시설), educationFacility(교육시설), welfareFacility(부대복리시설)

호출 한도: 일 1,000회

인증·비용·약관

인증 방식ServiceKey — data.go.kr 인증키. 프록시 서버에만 보관하며 에이전트에게 노출하지 않는다. 에이전트는 우리 간편 API(/api/apt) 또는 X-Agent-Token 프록시만 호출한다.
비용무료. 자동승인
이용허락공공데이터: 출처표시(제1유형)
재배포허용 (출처표시 필수)
약관 확인일2026-10-13
활용신청data.go.kr 로그인 → 국토교통부_공동주택 기본 정보제공 서비스 활용신청 → 인증키 발급 (자동승인) 포털 바로가기
운영 상태active
최종 확인일2026-10-13

에이전트 호출 방법

우리 프록시를 통해 호출합니다. 헤더 X-Agent-Token이 필요합니다. 토큰 발급은 /agencatalog/register/에서 신청 후 승인받습니다. 전체 서비스 목록은 /agencatalog/api/services.json을 참조하세요.

예시: POST /agencatalog/api/call {service:'molit-apt-basis-info', endpoint:'getAphusBassInfoV5', params:{kaptCode:'A10025972'}}

기계용 JSON 스키마

{
  "service": "molit-apt-basis-info",
  "name": "국토교통부 공동주택 기본 정보제공 서비스",
  "provider": "국토교통부",
  "apis": [
    {
      "id": "getAphusBassInfoV5",
      "name": "공동주택 기본 정보조회",
      "params": [
        {
          "name": "kaptCode",
          "required": true,
          "example": "A10025972",
          "desc": "단지코드 (K-apt 단지코드, A+숫자)"
        },
        {
          "name": "numOfRows",
          "required": false,
          "example": "10"
        },
        {
          "name": "pageNo",
          "required": false,
          "example": "1"
        },
        {
          "name": "dataType",
          "required": false,
          "example": "JSON"
        }
      ]
    },
    {
      "id": "getAphusDtlInfoV5",
      "name": "공동주택 상세 정보조회",
      "params": [
        {
          "name": "kaptCode",
          "required": true,
          "example": "A10025972",
          "desc": "단지코드 (K-apt 단지코드, A+숫자)"
        },
        {
          "name": "numOfRows",
          "required": false,
          "example": "10"
        },
        {
          "name": "pageNo",
          "required": false,
          "example": "1"
        },
        {
          "name": "dataType",
          "required": false,
          "example": "JSON"
        }
      ]
    }
  ],
  "proxy_call": "POST /agencatalog/api/call",
  "attribution": "출처: 국토교통부 공동주택 기본 정보제공 서비스(공공데이터포털 data.go.kr)"
}

이용 시 주의사항

  • 기관 API 키는 서버에만 보관됩니다. 직접 키를 요청하는 클라이언트는 이 경로를 사용할 수 없습니다.
  • 기관별 일일 한도가 있습니다. 한도 초과 시 429를 반환하고 추가 호출을 차단합니다.
  • 기관 API 장애·한도 초과 시 오류가 전달됩니다. 재시도 전에 응답의 error 필드를 확인하세요.
  • 출처 표기: 출처: 국토교통부 공동주택 기본 정보제공 서비스(공공데이터포털 data.go.kr)

마지막 확인: 2026-10-13