Service
전국 상가업소를 위치, 행정구역, 업소 번호로 찾고 업종 분류와 행정구역 코드, 한 지점 주변의 주요 상권을 소상공인시장진흥공단 공공데이터로 제공합니다.
97.14%30일 가동률평균 응답287ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-store-registry/get-store | Reads one registered store in South Korea by its registry id. Use when a store_id from a search needs its full record, or to check that a store is still registered. Do NOT use to search by name or location. Returns the store's name, branch, category codes and names, industry, province, district, dong, addresses, postal code, building, floor, unit and coordinates with the registry's data_month; an unknown id is a not-found error. | |
| POST | /v1/korea-store-registry/list-areas | Lists the administrative area codes the store registry uses at one level: provinces (2 digits), the districts of a province (5) or the administrative dongs of a district (8). Use when search-stores-in-area needs an area_code, or to translate an area code into its name. Do NOT use to list stores. Returns areas with code, name, level, parent_code and the table's published_on date. | |
| POST | /v1/korea-store-registry/list-business-categories | Lists the business category codes of the store registry at one level: large (2 characters), middle (4) or small (6), optionally only the ones under a parent category. Use when a store search needs a category_code, or to translate a category code into its name. Do NOT use to list stores. Returns categories with code, name, level, parent_code and the table's published_on date. | |
| POST | /v1/korea-store-registry/search-commercial-zones-nearby | Lists the major commercial zones of South Korea that fall within a radius of up to 2,000 metres around a point, nearest first. Use when someone asks which shopping or business districts are around a place. Do NOT use to list stores (use search-stores-nearby). Returns zones with zone_id, name, province and district, area_square_meters, the centre coordinates, distance_meters and, on request, the boundary polygon; an empty list means no zone within the radius. | |
| POST | /v1/korea-store-registry/search-stores-in-area | Lists the registered stores of one province, district or administrative dong in South Korea by its area code, optionally only one business category, one page at a time. Use when someone names an administrative area and wants its shops or restaurants, or wants to count them. Do NOT use for a place or coordinates (use search-stores-nearby). Returns stores with store_id, name, category codes and names, address, floor and coordinates, plus total_count, has_more and the registry's data_month; area codes come from list-areas. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-store-registry/search-stores-nearby | Lists the registered stores within a radius of up to 2,000 metres around a point in South Korea, optionally only one business category, one page at a time. Use when someone gives a place or coordinates and wants the shops, restaurants or services around it. Do NOT use to find a store by name, or for an area by its code (use search-stores-in-area). Returns stores with store_id, name, category codes and names, address, floor, coordinates and distance_meters, plus total_count, has_more and the registry's data_month. |