개발가이드

  • 개발가이드

도로명주소 조회

주소 검색을 통해 도로명 주소를 조회합니다.

정보

Method
URL
POST
https://apick.app/rest/search_juso

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
juso
String
O
주소(지번, 도로명)
page
String
O
검색 결과 조회 페이지
(페이지당 10건씩 조회, total_count 필드를 통해 전체 검색결과 개수 파악 가능)

응답

Body
이름
타입
설명
data
Object
조회 데이터
result
Array
주소 목록
{}
Object
주소 정보
detBdNmList
String
상세건물명
engAddr
String
도로명주소(영문)
rn
String
도로명
emdNm
String
읍면동명
zipNo
String
우편번호
roadAddrPart2
String
도로명주소 참고항목
emdNo
String
읍면동일련번호
sggNm
String
시군구명
jibunAddr
String
지번 정보
siNm
String
시도명
roadAddrPart1
String
도로명주소(참고항목 제외)
bdNm
String
건물명
admCd
String
행정구역코드
udrtYn
String
지하여부
(0: 지상, 1: 지하)
lnbrMnnm
String
지번본번(번지)
roadAddr
String
전체 도로명주소
lnbrSlno
String
지번부번(호) (부번이 없는 경우 0)
buldMnnm
String
건물본번
bdKdcd
String
공동주택여부
(1: 공동주택, 0: 비공동주택)
liNm
String
법정리명
rnMgtSn
String
도로명코드
mtYn
String
산여부
(0: 대지, 1: 산)
bdMgtSn
String
건물관리번호
buldSlno
String
건물부번 (부번이 없는 경우 0)
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/search_juso" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "juso=디지털로"  \
-F "page=1"
응답 예시

{
    "data": {
        "result": [
            {
                "detBdNmList": "제1동",
                "engAddr": "226 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08395",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 135-6 디지털로 크림슨빌딩",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 226",
                "bdNm": "디지털로 크림슨빌딩",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "135",
                "roadAddr": "서울특별시 구로구 디지털로 226 (가리봉동)",
                "lnbrSlno": "6",
                "buldMnnm": "226",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101350006015722",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "",
                "engAddr": "239 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08388",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 133-34",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 239",
                "bdNm": "",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "133",
                "roadAddr": "서울특별시 구로구 디지털로 239 (가리봉동)",
                "lnbrSlno": "34",
                "buldMnnm": "239",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101330034015848",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "에이스 가산타워",
                "engAddr": "121 Digital-ro, Geumcheon-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가산동",
                "zipNo": "08505",
                "roadAddrPart2": " (가산동)",
                "emdNo": "01",
                "sggNm": "금천구",
                "jibunAddr": "서울특별시 금천구 가산동 550-9 에이스가산타워",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 금천구 디지털로 121",
                "bdNm": "에이스가산타워",
                "admCd": "1154510100",
                "udrtYn": "0",
                "lnbrMnnm": "550",
                "roadAddr": "서울특별시 금천구 디지털로 121 (가산동)",
                "lnbrSlno": "9",
                "buldMnnm": "121",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115453000026",
                "mtYn": "0",
                "bdMgtSn": "1154510100105500009015661",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "",
                "engAddr": "218 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08395",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 135-10",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 218",
                "bdNm": "",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "135",
                "roadAddr": "서울특별시 구로구 디지털로 218 (가리봉동)",
                "lnbrSlno": "10",
                "buldMnnm": "218",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101350010016050",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "",
                "engAddr": "219 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08388",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 131-20",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 219",
                "bdNm": "",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "131",
                "roadAddr": "서울특별시 구로구 디지털로 219 (가리봉동)",
                "lnbrSlno": "20",
                "buldMnnm": "219",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101310020015560",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "",
                "engAddr": "220 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08395",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 135-9",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 220",
                "bdNm": "",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "135",
                "roadAddr": "서울특별시 구로구 디지털로 220 (가리봉동)",
                "lnbrSlno": "9",
                "buldMnnm": "220",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101350009016034",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "",
                "engAddr": "221 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08388",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 131-19",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 221",
                "bdNm": "",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "131",
                "roadAddr": "서울특별시 구로구 디지털로 221 (가리봉동)",
                "lnbrSlno": "19",
                "buldMnnm": "221",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101310019015980",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "",
                "engAddr": "222 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08395",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 135-9",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 222",
                "bdNm": "",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "135",
                "roadAddr": "서울특별시 구로구 디지털로 222 (가리봉동)",
                "lnbrSlno": "9",
                "buldMnnm": "222",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101350009016019",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "",
                "engAddr": "223 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08388",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 131-19",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 223",
                "bdNm": "",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "131",
                "roadAddr": "서울특별시 구로구 디지털로 223 (가리봉동)",
                "lnbrSlno": "19",
                "buldMnnm": "223",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101310019015952",
                "buldSlno": "0"
            },
            {
                "detBdNmList": "",
                "engAddr": "224 Digital-ro, Guro-gu, Seoul",
                "rn": "디지털로",
                "emdNm": "가리봉동",
                "zipNo": "08395",
                "roadAddrPart2": " (가리봉동)",
                "emdNo": "02",
                "sggNm": "구로구",
                "jibunAddr": "서울특별시 구로구 가리봉동 135-9",
                "siNm": "서울특별시",
                "roadAddrPart1": "서울특별시 구로구 디지털로 224",
                "bdNm": "",
                "admCd": "1153010300",
                "udrtYn": "0",
                "lnbrMnnm": "135",
                "roadAddr": "서울특별시 구로구 디지털로 224 (가리봉동)",
                "lnbrSlno": "9",
                "buldMnnm": "224",
                "bdKdcd": "0",
                "liNm": "",
                "rnMgtSn": "115303000026",
                "mtYn": "0",
                "bdMgtSn": "1153010300101350009016002",
                "buldSlno": "0"
            }
        ],
        "total_count": "2339",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 2,
        "ms": 104,
        "pl_id": 343
    }
}
현재 페이지 북마크