Service
(재)예술경영지원센터 공연예술통합전산망(KOPIS)의 공연·축제·공연시설·예매상황판·티켓판매 통계를 조회합니다. 출처 : (재)예술경영지원센터 공연예술통합전산망 www.kopis.or.kr. 집계 데이터는 공연예술통합전산망 연계기관의 티켓판매시스템에서 발권된 분량을 기준으로 제공하므로 해당 공연의 전체 관객 수와 차이가 있을 수 있습니다.
98.18%30일 가동률평균 응답316ms
행을 선택하면 해당 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 | 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. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| 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. |