Service
Registered shops, restaurants and other small businesses across South Korea by location, district or store id, their business categories, the administrative area codes, and the major commercial zones around a point, from the Small Enterprise and Market Service public data.
100.00%30-day uptimeAvg response307ms
Selecting a row opens the reference for that 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. |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
| 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. |