Service
Tourist attractions, cultural venues, festivals, restaurants, shopping and places to stay across South Korea, searched by keyword, region, category or location and read in full detail, from the Korea Tourism Organization's public tourism database.
100.00%30-day uptimeAvg response273ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-tour/get-attraction | Reads one place in South Korea in full by its content_id: overview, address, coordinates, homepage, opening hours, closed days, fees, parking, contact, event dates, check-in times or menu as its type provides, and its photo gallery. Use after a search returned a content_id and the caller wants the details. Do NOT use to find places (use the search operations). Returns the place's fields plus overview, homepage_url, details and images; details fields the type does not have are null. | |
| POST | /v1/korea-tour/list-regions | Lists the provinces of South Korea, or the districts of one province, with the numeric codes the other operations take as region_code and district_code. Use when you need a code for a province or district, or want to see which districts a province has. Do NOT use to find places; use search-attractions or search-nearby. Returns regions with code and name, and parent_code when the list is one province's districts. | |
| POST | /v1/korea-tour/search-attractions | Finds tourist attractions, cultural venues, festivals, courses, leisure spots, accommodation, shops and restaurants in South Korea by keyword, by province and district, by place type, by classification code, or any combination. Use when someone names a place or asks what a region or category has. Do NOT use for places around a point (use search-nearby), for festivals by date (use search-festivals) or to read one place in full (use get-attraction). Returns places with content_id, place_type, name, address, coordinates, codes and main image, one page at a time with total_count and has_more. | |
| POST | /v1/korea-tour/search-festivals | Lists festivals, performances and events in South Korea that are running on or after a date, optionally only those starting by an end date and only in one province or district. Use when someone asks what is on, now or in a coming period. Do NOT use for permanent attractions (use search-attractions) or for an event's full programme (use get-attraction with its content_id). Returns festivals with event_start_date, event_end_date, content_id, name, address, coordinates and main image, one page at a time with total_count and has_more. |
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-tour/search-nearby | Lists the attractions, venues, restaurants, shops and stays within a radius of a WGS84 point in South Korea, nearest first, optionally of one place type. Use when someone gives a location or coordinates and wants what is around it. Do NOT use to search by name (use search-attractions) or beyond 20 km. Returns places with distance_meters, content_id, place_type, name, address, coordinates and main image, one page at a time with total_count and has_more; an empty list means nothing within the radius. |
| POST | /v1/korea-tour/search-stays | Lists hotels, motels, pensions, guesthouses and other accommodation in one province of South Korea, optionally in one district or one accommodation category. Use when someone wants places to stay in an area. Do NOT use for stays around a point (use search-nearby with type accommodation) or for room rates, which this data does not carry. Returns stays with content_id, name, address, coordinates, category_path and main image, one page at a time with total_count and has_more. |