Service
Searches the official Korea Culture Information Service and normalizes event identifiers, dates, categories, locations, coordinates, prices, and detail links.
100.00%30-day uptimeAvg response815ms
Selecting a row opens the reference for that 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). |
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-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). |
