Service
전국의 관광지, 문화시설, 축제, 음식점, 쇼핑, 숙박을 키워드·지역·분류·위치로 찾고 상세 정보까지 읽는 한국관광공사 공공 관광정보입니다.
97.14%30일 가동률평균 응답279ms
행을 선택하면 해당 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. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| 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. |