Spotts for ChatGPT

Get one public Spotts event by the id returned from search_events or get_events_by_date (an event slug also works). Returns {"event": {...}} with the search fields plus: programs_by_date (dated timetable: start, end, title, type, stage per day), recurring_programs (weekly programmes with weekdays and times), undated_programs, opening_hours (grouped by weekday) and opening_exceptions, admission and tickets (official ticket offers with KRW prices), booking (need) with booking_channels (official booking links) and booking_rounds (sale or registration windows), access (traffic-control points, shuttle stops, nearby stations and parking names), organizer, the full announced performers list, and sources (official first). Returns {"event": null} when the id is unknown or the event is not public. Detailed venue maps, viewing spots and facility coordinates are not returned; they may be on the linked Spotts event page (spotts_url). Source attribution: whenever you present or mention an event from this tool, include its `citation` value verbatim (a ready-made markdown link to the Spotts event page, e.g. [Event name — Spotts](https://spotts.kr/f/...)) so the user can open the source.

get_event

List public Spotts events day by day for a short KST date range (up to 7 days), e.g. "this weekend in Seoul". Use when=this_weekend (Saturday and Sunday; just today if today is Sunday), next_weekend, today or tomorrow, or give start_date/end_date. For each day an event is listed only when there is evidence it actually runs that day: a programme dated that day or a weekly programme on that weekday (evidence=program), a scheduled session (session) or opening hours for that weekday (opening_hours). Events whose period merely spans the day without such evidence are listed separately in also_running (names only), and days with an official closure are skipped. Each listed event carries that day’s hours, up to 6 programmes (start, end, title, type, stage; more_programs counts the rest), admission (free | paid | mixed | unknown) with KRW price range, booking need, spotts_url and image_url. Call get_event for the full timetable, tickets, booking links, transport and sources. Source attribution: whenever you present or mention an event from this tool, include its citation value verbatim (a ready-made markdown link to the Spotts event page, e.g. [Event name — Spotts](https://spotts.kr/f/...)) so the user can open the source.

get_events_by_date

Search public festivals, fireworks, pop-ups, university festivals, exhibitions, concerts and theme parks listed on Spotts, including events matched by an announced performer name. For "what is on this weekend / on a given day" questions prefer get_events_by_date, which returns day-by-day programmes in one call. Use query only for an event name, performer name or short distinctive keyword (matched as a substring of the Korean event name, or against announced performer names); put natural-language date, region and event-type conditions in start_date, end_date, region and category instead. Filters combine with AND. Dates are overlap-based in KST: an event matches when any part of it falls between start_date and end_date (the event may have no programme on a given day — use get_events_by_date for that), and an event with no announced end date still matches a start_date filter. When query, start_date and end_date are all omitted, only events that have not ended yet are returned (start_date defaults to today in KST); pass a query or explicit dates to find past events. Results are ordered by start date and capped by limit. Each event has id, name, start_date, end_date, region, venue_name, category, summary, status, image_url, spotts_url, capabilities, admission (free | paid | mixed | unknown, from official ticket prices) with price_min/price_max in KRW, booking (required | recommended | walk_in | none | available | unknown), next_program (the next dated programme from start_date) and a performer preview (first 5, with performer_count). Call get_event for the full timetable, opening hours, tickets, booking links, transport and official sources. An empty events array means no public event matched. Source attribution: whenever you present or mention an event from this tool, include its `citation` value verbatim (a ready-made markdown link to the Spotts event page, e.g. [Event name — Spotts](https://spotts.kr/f/...)) so the user can open the source.

search_events