인증 방식
🔑 API Key
요금
무료
Base URL
business.juso.go.kr/addrlink
태그
주소, 도로명
서비스 소개
행정안전부에서 제공하는 공식 도로명주소 검색 API입니다. 키워드로 주소를 검색하면 도로명주소, 지번주소, 우편번호, 건물명, 좌표(위경도)를 반환합니다. JavaScript 팝업 위젯도 제공하여 빠른 통합이 가능합니다.
🚀 시작하기
- 1
도로명주소 개발자센터 신청
business.juso.go.kr → 오픈 API 신청 → 활용 목적 작성 (승인 1~2일)
- 2
확인키 발급
신청 승인 후 확인키(API Key) 이메일 수신
- 3
팝업 위젯 또는 REST API 선택
팝업: 자바스크립트 위젯으로 빠른 통합. REST: 서버에서 직접 검색
📋 응답 예시
{
"results": {
"juso": [{
"roadAddr": "서울특별시 강남구 테헤란로 152",
"jibunAddr": "서울특별시 강남구 역삼동 737",
"zipNo": "06236",
"bdNm": "강남파이낸스센터",
"x": "127.036030",
"y": "37.500153"
}]
}
}💡 코드 예제
JavaScriptREST API (주소 검색)
async function searchAddress(keyword: string) {
const res = await fetch(
`https://business.juso.go.kr/addrlink/addrLinkApi.do?` +
new URLSearchParams({
confmKey: process.env.JUSO_API_KEY!,
currentPage: '1',
countPerPage: '10',
keyword,
resultType: 'json',
hstryYn: 'N',
firstSort: 'road',
addInfoYn: 'Y', // 좌표 포함
})
)
const data = await res.json()
return data.results.juso
}
const results = await searchAddress('강남파이낸스센터')
console.log(results[0].roadAddr) // 서울특별시 강남구 테헤란로 152JavaScript팝업 위젯 (HTML)
<!-- HTML에 추가 -->
<script src="//t1.daumcdn.net/mapjsapi/bundle/postcode/prod/postcode.v2.js"></script>
<script>
function openAddressSearch() {
new daum.Postcode({
oncomplete: function(data) {
document.getElementById('address').value = data.roadAddress
document.getElementById('zipcode').value = data.zonecode
}
}).open()
}
</script>
<!-- Kakao 우편번호 서비스 (무료, 키 불필요) -->
<button onclick="openAddressSearch()">주소 검색</button>
<input id="zipcode" placeholder="우편번호" />
<input id="address" placeholder="도로명주소" />