Service
한국문화정보원 공식 서비스를 검색하고 행사 식별자, 날짜, 분야, 장소, 좌표, 가격, 상세 링크를 정규화합니다.
100.00%30일 가동률평균 응답807ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-culture-event/event | Retrieves one culture event by passing the opaque event_id returned by an event search operation verbatim. Use when the user wants the full detail, ticket price, or contact of a specific search result. Do NOT use to find events — use korea-culture-event:search-events-by-period, korea-culture-event:search-events-by-area, or korea-culture-event:search-events-by-category instead. Returns the same normalized event fields as search results plus price_krw, price_text, is_free, detail_url, and contact_phone_e164 when the upstream provides them. | |
| POST | /v1/korea-culture-event/search-events-by-area | Searches culture events in one Korean province-level area, given its lowercase code (for example `seoul`), with an optional city, county, or district name and an optional exact YYYY-MM-DD date range. Use when the user names a region. Do NOT use for date-only or free-text queries — use korea-culture-event:search-events-by-period instead; for category-scoped queries use korea-culture-event:search-events-by-category. Query text and ordering are not supported here. to_date must be on or after from_date. Returns items (normalized events) and summary (pagination metadata with summary.cursor). | |
| POST | /v1/korea-culture-event/search-events-by-category | Searches culture events by one normalized official category (for example exhibition or traditional_korean_music), with an optional exact YYYY-MM-DD date range. Use when the user asks for a kind of event such as exhibitions, concerts, or festivals. Do NOT use for region-scoped queries — use korea-culture-event:search-events-by-area instead; for date-only or free-text queries use korea-culture-event:search-events-by-period. to_date must be on or after from_date. Returns items (normalized events) and summary (pagination metadata with summary.cursor). | |
| POST | /v1/korea-culture-event/search-events-by-period | Searches culture events whose run overlaps an exact YYYY-MM-DD date range, with an optional free-text query and optional ordering by registration_date, title, or area. Use when the user gives a date window, a search term, or a preferred sort order without restricting to one province or category; this is the only event search operation that accepts query and sort_by. Do NOT use for region-scoped queries — use korea-culture-event:search-events-by-area instead; for category-scoped queries use korea-culture-event:search-events-by-category. to_date must be on or after from_date. Returns items (normalized events with event_id, title, category, start_date, end_date, venue_name, province_code, district, coordinates, and thumbnail_url) and summary (pagination metadata with summary.cursor). |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/korea-culture-event/search-livelihood-culture | Searches culture-calendar entries from the upstream livelihood-culture feed, newest registration first. Use when the user wants culture-calendar listings such as programs or lectures registered by cultural institutions, rather than events with dates and venues. Do NOT use for events with start and end dates, venues, or categories — use korea-culture-event:search-events-by-period instead. This feed cannot be filtered by text: the upstream keyword parameter reports matches it never returns, so it is not offered here; use korea-culture-event:search-events-by-period for a free-text query. The upstream exposes only the registration date and organizer, so each entry carries title, organizer, registered_date, and detail_url but no event dates or venue. Returns items (calendar entries) and summary (pagination metadata with summary.cursor). |
