종합부동산웹앱 API 신청 명칭 정밀 확인
질의 원문
학교 알리미 open api도 모두 신청 했는데? 서울 열린 데이터광장키도 다 받은 것 같은데?
추가 신청 필요하다는 것은 공공데이터에서 해당항목을 추가하라는 거지? 만약 그렇다면 정확한 데이터 이름을 알려줘.
수집 시점
- 2026-08-12 12:51:45 +09:00
- 확인 경로: 공공데이터포털, 서울 열린데이터광장, NEIS 교육정보 개방 포털, 학교알리미, KOSIS, 금융감독원 금융상품 한눈에
정정 결론
- 학교알리미 Open API를 이미 모두 신청했다면 학교알리미는 추가 신청 대상이 아니다. 이 프로젝트에서는
SCHOOLINFO_API_KEY를 연결하고 학교알리미 응답 스키마를 파서로 고정하면 된다. - 서울 열린데이터광장 키를 이미 받았다면 서울 건축인허가·정비사업 공개 API는 추가 키 신청 대상이 아니다.
SEOUL_OPENDATA_KEY로 서비스명별 수집기와 페이징만 고정하면 된다. - "추가 신청 필요"는 대부분 공공데이터포털에서 기존 서비스키에 개별 OpenAPI 활용신청을 추가하라는 뜻이다. 단, KOSIS·금융상품 한눈에·NEIS·학교알리미·서울 열린데이터광장은 기관별 별도 키 체계다.
공공데이터포털에서 추가 활용신청할 정확한 데이터명
| 우선 | 구분 | 공공데이터포털 데이터명 | 데이터 ID/URL | 비고 |
|---|---|---|---|---|
| 필수 | 열차 운행 | 한국철도공사_열차운행정보 | 15125762 | 열차 운행계획·운행정보·코드정보. |
| 필수 | 도로교통량 | 국토교통부_한국건설기술연구원 교통량 통계 데이터 정보조회서비스 | 15097077 | 교통량 기반 입지·접근성 분석. |
| 필수 | 연구정보 | 경제인문사회연구회 연구정보 | 15013677 | NKIS 연구보고서/정책자료 메타데이터. |
| 필수 | 정책연구 | 행정안전부_정책연구 과제정보 | 15080254 | 정책연구 과제명·수행기관·기간·개요. |
| 필수 | 온비드 공매 | 한국자산관리공사_차세대 온비드 부동산 물건목록 조회서비스 | 15157207 | 공매 부동산 목록. |
| 필수 | 온비드 공매 | 한국자산관리공사_차세대 온비드 부동산 물건상세 조회서비스 | 15157247 | 물건관리번호 기반 상세. |
| 필수 | 온비드 공매 | 한국자산관리공사_차세대 온비드 공고목록 조회서비스 | 15157216 | 공고 목록. |
| 필수 | 온비드 공매 | 한국자산관리공사_차세대 온비드 공고상세 조회서비스 | 15157218 | 공고 상세. |
| 필수 | 온비드 공매 | 한국자산관리공사_차세대 온비드 공고 입찰결과목록 조회서비스 | 15157222 | 입찰결과 목록. |
| 필수 | 온비드 공매 | 한국자산관리공사_차세대 온비드 물건 입찰결과상세 조회서비스 | 15157254 | 물건별 입찰결과 상세. |
| 선택 | 온비드 통계 | 한국자산관리공사_차세대 온비드 지역별 입찰 통계 조회서비스 | 15157756 | 지역별 공매 시장 통계용. |
| 정밀 시 추가 | 주민등록 세대 | 행정안전부_법정동별(행정동 통반단위) 주민등록 인구 및 세대현황 | 15108071 | KOSIS 시군구 세대수보다 더 세밀한 통반 단위. |
| 정밀 시 추가 | 주민등록 세대 | 행정안전부_행정동별(통반단위) 세대원수별 주민등록 세대수 | 15108081 | 세대원수별 세대 구조 분석. |
| 선택 | 항만 | 해양수산부_항만기본계획(무역항 연안항)_20240717 | 15129889 | 파일형 데이터. API 자동변환을 쓰려면 공공데이터포털 활용신청이 필요할 수 있다. |
| 선택 | 철도역 | 국가철도공단_도시광역철도_역사정보_20241231 | 15093755 | 파일형 데이터. 역명·노선·위경도·운영기관·주소는 파일 파서로 충분하다. |
| 선택 | NEIS 대체 | 교육부_나이스(NEIS) 교육정보 개방 포털_초중등_학교기본정보 | 15122275 | NEIS 포털 키가 있으면 별도 공공데이터포털 신청보다 NEIS 직접 API를 우선한다. |
| 선택 | 학원/교습소 파일 | 한국교육학술정보원_대국민에 제공되는 학원교습소구분 학원명 등 학원교습소 정보_20190401 | 15154468 | NEIS 학원교습소정보가 본원천. 파일형 보조 원천으로 둔다. |
공공데이터포털이 아닌 별도 키/계정 대상
| 항목 | 정확한 신청/키 | 현재 판단 |
|---|---|---|
| 학교알리미 | 학교알리미 Open API | 사용자가 이미 모두 신청했다면 추가 신청 없음. 수집기 구현 대상. |
| NEIS | NEIS 교육정보 개방 포털 인증키, 우선 학교기본정보, 학원교습소정보 | NEIS 키가 이미 있으면 추가 신청 없음. 학교알리미와 별도 체계다. |
| 서울 건축인허가 | 서울 열린데이터광장 인증키, 서비스 서울시 건축인허가 기본개요 등 | 서울 키가 있으면 추가 신청 없음. OA-22404~22437 서비스별 파서 구현 대상. |
| 서울 정비사업/정비몽땅 | 서울 열린데이터광장 인증키와 정비사업 정보몽땅 공개 페이지/첨부 | CleanupPartnersInfo, OA-22856 등은 서울 키와 파일 파서로 처리한다. |
| KOSIS 시군구 세대수 | KOSIS API 키, org 101, table DT_1B040B3 | KOSIS 키가 있으면 추가 공공데이터포털 신청 없음. |
| 금융상품통합비교공시 | 금융감독원 금융상품 한눈에 Open API 인증키 | 공공데이터포털이 아니라 금융상품 한눈에 키. |
서울 열린데이터광장 키 보유 시 구현할 서비스명
서울 열린데이터광장 키가 이미 있으면 아래는 추가 신청이 아니라 수집기 구현 목록이다.
| 묶음 | 서비스명 |
|---|---|
| 건축인허가 | 서울시 건축인허가 기본개요, 서울시 건축인허가 동별개요, 서울시 건축인허가 층별개요, 서울시 건축인허가 호별개요, 서울시 건축인허가 전유공용면적표, 서울시 건축인허가 호별전유공용면적표, 서울시 건축인허가 오수정화시설, 서울시 건축인허가 주차장, 서울시 건축인허가 지역지구구역 |
| 주택인허가 | 서울시 주택인허가 기본개요, 서울시 주택인허가 동별개요, 서울시 주택인허가 층별개요, 서울시 주택인허가 호별개요, 서울시 주택인허가 전유공용면적표, 서울시 주택인허가 행위전유공유면적표, 서울시 주택인허가 오수정화시설, 서울시 주택인허가 주차장, 서울시 주택인허가 지역지구구역 |
| 건축물대장 | 서울시 건축물대장 기본개요, 서울시 건축물대장 총괄표제부, 서울시 건축물대장 표제부, 서울시 건축물대장 층별개요, 서울시 건축물대장 전유부, 서울시 건축물대장 전유공유면적표, 서울시 건축물대장 오수정화시설, 서울시 건축물대장 지역지구구역 |
| 폐쇄말소대장 | 서울시 폐쇄말소대장 기본개요, 서울시 폐쇄말소대장 총괄표제부, 서울시 폐쇄말소대장 표제부, 서울시 폐쇄말소대장 층별개요, 서울시 폐쇄말소대장 전유부, 서울시 폐쇄말소대장 전유공유면적표, 서울시 폐쇄말소대장 오수정화시설, 서울시 폐쇄말소대장 지역지구구역 |
| 정비사업 | 서울특별시 도시정비사업 통계, 서울시 정비사업 협력업체 현황/API 서비스명 CleanupPartnersInfo |
지방행정 인허가(localdata) 우선 신청 후보
지방행정 인허가 195종 전체를 한 번에 모두 붙이기보다, 부동산 정밀 분석에 바로 쓰는 업종부터 공공데이터포털에서 활용신청한다.
| 우선 | 공공데이터포털 데이터명 | 비고 |
|---|---|---|
| 1 | 행정안전부_생활_대규모점포 조회서비스 | 상권·생활편의 앵커. |
| 1 | 행정안전부_문화_숙박업 조회서비스 | 생활숙박·일반숙박 인허가. |
| 1 | 행정안전부_문화_관광숙박업 조회서비스 | 관광호텔 등 관광숙박 인허가. |
| 2 | 행정안전부_문화_관광펜션업 조회서비스 | 관광지/세컨드하우스형 수요 분석 보조. |
| 2 | 행정안전부_문화_한옥체험업 조회서비스 | 한옥·관광형 지역 분석 보조. |
| 2 | 한국산업단지공단_공장등록생산정보조회서비스 | 공장·산단 배후 수요 분석. |
| 2 | 한국산업단지공단_공장등록필지정보조회서비스 | 필지 단위 공장 입지 분석. |
| 2 | 국토교통부_부동산중개업자정보_20250826 | 파일형 전국 중개업자 정보. API보다 파일 파서 우선. |
구현 판단
- 사용자가 이미 받은 학교알리미·서울 열린데이터광장 키는 신청 단계가 끝난 것으로 본다.
- 다음 작업에서는
reports/api_readiness.md의 상태명을 더 엄밀하게 바꿀 필요가 있다. 예:추가신청필요,키보유-수집기필요,파일파서필요,별도기관키필요. - 공공데이터포털 활용신청 목록은 위 표의 "필수"부터 처리하고, 서울·학교알리미는 키 확인과 샘플 호출 테스트로 넘어간다.
한계
- 포털의 데이터명과 데이터 ID는 기관 개편·서비스 대체로 변경될 수 있어, 실제 활용신청 화면에서 동일 명칭/ID를 다시 대조해야 한다.
- 학교알리미와 서울 열린데이터광장 키의 실제 발급 상태는 로컬 환경변수나 계정 화면을 직접 확인하지 못했다.
후속 확인
- 2026-08-12 후속 확인에서 서울 열린데이터광장 키는
C:\Users\progd\.claude\.secrets.env에SEOUL_OPENDATA_KEY로 저장되어 있고, 이 프로젝트의load_env()에서도 인식되는 것을 확인했다. - research 프로젝트에는 학교알리미 Open API endpoint와 UUID 수집 노하우는 있으나
SCHOOLINFO_API_KEY계열 키 저장 흔적은 없었다. - 상세 결과는
2026-08-12-종합부동산웹앱-api키-실보유확인.md에 기록했다.
원문 Markdown: docs/analysis/2026-08-12-종합부동산웹앱-api신청명칭-정밀확인.md