Service
Performances, festivals, venues, box office rankings and ticket sales statistics of South Korea's performing arts from KOPIS, the Korea Performing Arts Box Office Information System of the Korea Arts Management Service (source: (재)예술경영지원센터 공연예술통합전산망 www.kopis.or.kr). Rankings and sales count tickets issued through the ticketing systems linked to KOPIS and may differ from a performance's total audience.
98.05%30-day uptimeAvg response255ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/korea-performance/get-box-office | Reads the KOPIS box office ranking for a date window of up to 31 days: up to 50 performances ranked by tickets sold, optionally one genre or the children's or open-run list, one region, or one hall size. Use when someone asks which performances sold best in a period. Do NOT use to search by title (use search-performances) or for totals per day (use get-ticket-sales-stats). Returns rankings with rank, performance id, title, genre, run dates, venue, region, seat count, show count and poster. Figures count tickets issued through the ticketing systems linked to KOPIS and may differ from a performance's total audience (source: (재)예술경영지원센터 공연예술통합전산망 www.kopis.or.kr). | |
| POST | /v1/korea-performance/get-performance | Reads one performance in full by its id: dates, status, venue and hall ids, cast, crew, runtime, age limit, ticket prices, weekly schedule, synopsis, companies, poster, introduction images, booking sites and the open-run, touring, children's, Daehakro, festival and musical flags. Use after a search or a box office row gave a performance id. Do NOT use to find performances (use search-performances). Returns the performance; an unknown id is NO_DATA. | |
| POST | /v1/korea-performance/get-ticket-sales-stats | Reads KOPIS ticket sales statistics for a date window of up to 31 days, one row per day or one row per weekday (summed over the window): performances on sale, premieres, shows, bookings, cancellations, net tickets sold and net sales amount in KRW. Use when someone asks how many tickets were sold or how much the market took in a period or on which weekday. Do NOT use for rankings (use get-box-office). Returns rows with date or weekday and the counts. Figures count tickets issued through the ticketing systems linked to KOPIS, are refreshed twice a day and may be corrected later (source: (재)예술경영지원센터 공연예술통합전산망 www.kopis.or.kr). | |
| POST | /v1/korea-performance/get-venue |
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.
| Reads one venue (facility) in full by its id: facility type, opening year, seat count, phone, homepage, address, WGS84 coordinates, amenities (restaurant, cafe, convenience store, playroom, nursing room, parking) and accessibility (parking, restroom, ramp, elevator), plus its halls with seat counts, stage facilities and accessible seats. Use after search-venues gave a venue_id. Do NOT use to find venues (use search-venues). Returns the venue with halls; an unknown id is NO_DATA. |
| POST | /v1/korea-performance/search-festivals | Lists performing arts festivals whose run overlaps a date window of up to 31 days, with the same title, venue, genre, hall, region, status, children's and last-update filters as search-performances. Use when someone asks for festivals in a period or a place. Do NOT use for ordinary performances (use search-performances). Returns festivals with id, title, dates, venue, genre, status and poster, one page at a time; the list has no total, has_more means the page was full. |
| POST | /v1/korea-performance/search-performances | Lists performances (plays, musicals, concerts, dance, traditional music, circus and mixed genres) whose run overlaps a date window of up to 31 days, optionally narrowed by title keyword, venue keyword, genre, hall, region or district, status, children's shows, open runs and last update. Use when someone asks what is on, where and when, in a period or a place. Do NOT use to read one performance in full (use get-performance), for festivals only (use search-festivals) or for rankings (use get-box-office). Returns performances with id, title, dates, venue, region, genre, status, open-run flag and poster, one page at a time; the list has no total, has_more means the page was full. |
| POST | /v1/korea-performance/search-venues | Lists performance venues (facilities) by name keyword, region or district and last update, with their facility type, hall count and opening year. Use when someone names a venue or asks what venues a district has, and to get a venue_id. Do NOT use to read a venue's address, coordinates or halls (use get-venue). Returns venues with id, name, hall count, facility type, region, district and opening year, one page at a time; the list has no total, has_more means the page was full. |