Grind away: 도로명주소 조회 API · 기타 자동화 · 호출당 과금 REST API

APICK · SERVICE BROCHURE · 기타

도로명주소 조회 API

키워드로 행정안전부 도로명주소 데이터베이스를 검색해 후보 주소를 반환하는 API

💳 호출당 Not specified in documentation ⚡ 실시간 응답 🔐 단일 인증키 📡 REST 표준

About APICK

APICK 은 어떤 서비스인가요?

APICK(에이픽) 은 금융·사업자·부동산·신분증·OCR·이미지·문서까지 80여 종의 비즈니스 API 를 REST 표준으로 제공하는 호출당 과금 플랫폼 입니다. 단일 인증키 CL_AUTH_KEY 하나로 모든 API 를 사용할 수 있고, 월 최소 비용 없이 호출한 만큼만 과금되는 투명한 요금 정책이 특징입니다.

✅ 단일 인증키 · 80+ REST API 통합 사용 — 한 번 가입하면 추가 계약 없이 바로 확장
✅ 호출당 포인트 과금 · 월 최소 비용 없음 — 트래픽 규모와 무관하게 부담 없이 시작
✅ 실시간 응답 · 호출 메타 자동 제공 — api.cost · api.ms · api.pl_id 자동 기록

APICK 회원가입 · 지금 시작하기 →

왜 APICK 인가 · 3가지 핵심 강점

정찰제 · 투명 가격

모든 API 가격이 정찰제로 공개되어 누구나 동일한 조건으로 이용합니다.

가입 즉시 전체 사용

회원가입 후 포인트 충전만으로 80여 종 API 를 즉시 호출할 수 있습니다.

5분 연동 · 무심사

별도 인증·심사·계약 없이 가입 후 5분 안에 모든 API 를 연동합니다.

주요 서비스 분야

금융·계좌 인증

계좌 실명 조회 · 은행코드 · 1원 인증 · 거래영업일

사업자·기업

사업자 정보 · 벤처기업 · 휴폐업 · 세무 상태

부동산·등기

건축물대장 · 인터넷등기소 · 토지대장 · 공시지가

개인·신분증 인증

주민번호 진위 · 신분증 OCR·진위 · 개인통관부호

이미지·영상·음성

얼굴 감지·블러 · 워터마크 · STT · TTS · 음성 변환

웹·문서·주소·검색

구글·유튜브 · URL 스크린샷 · PDF·DOCX 변환 · 도로명

한눈에 보는 연동 사양

엔드포인트

/rest/search_juso

REST · POST 요청

호출 단가

정책 별도

후불제 정책 별도 · 호출당

응답 시간

api.ms

응답 본문 api.ms 값으로 확인

핵심 특장점 · 빠른 도입 포인트

연동 담당자가 가장 먼저 확인하면 좋은 6가지 포인트입니다.

최소 입력 · 즉시 응답

필수 파라미터만 전달하면 평균 10초 이내, 최대 35초 응답으로 실시간 검증이 가능합니다.

표준 인증 방식

CL_AUTH_KEY (MD5 인증키) 를 헤더로 전달. 별도 OAuth 흐름 없이 즉시 호출 가능합니다.

호출 메타 자동 제공

응답에 api.cost · api.ms · api.pl_id 가 함께 반환되어 과금·성능·결제 로그를 즉시 추적할 수 있습니다.

투명한 과금

선불제 호출당 과금 · 후불제 정책 별도. 응답 본문 api.cost 로 실제 차감 포인트를 확인합니다.

단순 REST 인터페이스

표준 POST 요청 + FormData 형식으로 어떤 언어·프레임워크에서도 즉시 통합 가능합니다.

실패 응답 처리

data.success 값으로 판단: 0 실패 · 1 성공 · 3 타임아웃. 실패 응답은 정책에 따라 과금되지 않을 수 있습니다.

도입 효과

호출 메타 자동 제공 · 표준 REST 인터페이스 · 실시간 응답으로 기존 서비스 흐름에 즉시 편입됩니다.

✅ 호출 메타 자동 제공

api.cost / api.ms / api.pl_id 로 호출당 과금·성능·결제 로그를 즉시 추적합니다.

✅ 표준 REST 인터페이스

단순 POST + FormData 구조로 어떤 언어·프레임워크에서도 즉시 통합됩니다.

✅ 실시간 응답

평균 10초 이내 응답으로 사용자 흐름 중간에 자연스럽게 호출할 수 있습니다.

연동 사양 요약

Method	POST
Endpoint	`https://apick.app/rest/search_juso`
Header	CL_AUTH_KEY(인증키(MD5))
FormData	값: juso, page
Response	data · api 객체
api 객체	success · cost · ms · pl_id
success 값	0 실패 · 1 성공 · 3 타임아웃
응답시간	api.ms 값으로 확인 · 네트워크 상황에 따라 변동
과금 단위	Not specified in documentation / 호출당

요청 파라미터

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

요청 예시 · cURL

공식 가이드 기준 파라미터를 FormData 로 전달, 인증키는 헤더로 전달합니다.

curl -k -X POST "https://apick.app/rest/search_juso" \
  -H "CL_AUTH_KEY: $API_KEY" \
  -F "juso=sample" \
  -F "page=sample"

응답 예시 · JSON 샘플

표준 응답 구조 샘플입니다. 실제 필드·값은 호출 대상에 따라 달라질 수 있으며, 정확한 스펙은 공식 개발가이드를 기준으로 확인하세요.

{
  "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"
      }
    ],
    "total_count": "2339",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 2,
    "ms": 104,
    "pl_id": 343
  }
}

응답 필드

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

도입 체크리스트

Checklist

연동 작업 전 확인이 필요한 항목

✓APICK 회원가입 후 인증키(CL_AUTH_KEY) 발급

✓선불제 포인트 충전 또는 후불제 약정

✓호출 IP 화이트리스트 설정 검토

✓응답 객체 파싱 및 빈 값 처리 정책 수립

✓타임아웃(35초) 대응 로직 구현

✓api.cost 기반 과금 모니터링 구성

📄 도로명주소 조회 API 가이드 PDF 다운로드

지금 바로 APICK 에 연동해보세요

회원가입 즉시 CL_AUTH_KEY 발급.
도로명주소 조회 API 는 호출당 정책 별도, 월 최소 비용 없이 호출한 만큼만 과금됩니다.

APICK 회원가입 · 지금 시작하기 → 공식 개발 가이드 보기

* 본 문서는 APICK 공식 스펙을 바탕으로 정리한 연동 참고 자료입니다. 최신·정확한 스펙은 공식 개발 가이드 를 기준으로 확인하세요.

#APICK #에이픽 #비즈니스API #호출당과금API #RESTAPI #단일인증키API #월최소비용없는API #개발자API #도로명주소조회API

Grind away

2026년 4월 22일 수요일

도로명주소 조회 API · 기타 자동화 · 호출당 과금 REST API | APICK 에이픽