APIFuseAPIFuse
문서서비스플레이그라운드상태
로그인회원가입

Service

Korea Address Search

한국, 기타실험적
Playground에서 시험API 레퍼런스 열기

Overview

한국 도로명 주소 검색과 주소별 상세 정보(WGS84 좌표, 행정구역코드, 건물관리번호).

Status

정상

99.76%30일 가동률평균 응답316ms

2026-09-262026-10-112026-10-25

Setup

Auth mode
Managed key
Credentials
  • korea-address-search scope가 허용된 managed key
Sandbox
미제공

APIs

행을 선택하면 해당 API의 레퍼런스로 이동합니다.

MethodAPIPathSummary
POST/v1/korea-address-search/get-address-detailLooks up one exact road-name address and returns the WGS84 latitude and longitude of the building entrance, the 10-digit administrative district code, and the building management number. Use when you already have an exact road_address, as returned by korea-address-search:search-addresses. Do NOT use for keyword or partial address lookup — use korea-address-search:search-addresses first. Returns road_address, latitude, longitude, district_code, and building_management_number.
POST/v1/korea-address-search/search-addressesSearches Korean addresses by free-form query (road name, jibun, or building name). Use when you need candidate addresses or a postal code from a full or partial address string. Do NOT use for coordinates, district code, or building management number — use korea-address-search:get-address-detail instead. Returns addresses (road address, lot address, postal code, building name, province, and district), total_count, and the effective page and limit.

Related guides

  • sandbox key를 발급받고 첫 예약 생성까지 진행합니다.

  • 파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.

  • 예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.

  • 서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.

주소 상세 조회
주소 검색
빠른 시작
Managed key
개요
에러 모델