0 %
공연시설 목록
- 요청서비스
- 검색을 통한 공연시설 목록 서비스
※ 최대 100건까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfplc
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 서비스키 cpage o 3 현재페이지 1 rows o 3 페이지당 목록 수 5 (최대100건) shprfnmfct x 100 공연시설명 예술의전당(URLEncoding) fcltychartr x 4 공연시설특성코드 1 signgucode x 4 지역(시도)코드 11 signgucodesub x 4 지역(구군)코드 1111 afterdate x 8 해당일자 이후 등록/수정된 항목만 출력 20230101 - 요청/응답 메세지 예제
- 예술의전당으로 검색한 공연시설 목록을 1페이지 10개 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfplc?service={ServiceKey}&cpage=1&rows=10&shprfnmfct=예술의전당
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <dbs> <db> <fcltynm>경주예술의전당</fcltynm> <mt10id>FC000517</mt10id> <mt13cnt>2</mt13cnt> <fcltychartr>문예회관</fcltychartr> <sidonm>경북</sidonm> <gugunnm>경주시</gugunnm> <opende>2010</opende> </db> <db> <fcltynm>계룡문화예술의전당</fcltynm> <mt10id>FC000412</mt10id> <mt13cnt>2</mt13cnt> <fcltychartr>문예회관</fcltychartr> <sidonm>충남</sidonm> <gugunnm>계룡시</gugunnm> <opende>2011</opende> </db> <db> <fcltynm>군산예술의전당</fcltynm> <mt10id>FC000447</mt10id> <mt13cnt>2</mt13cnt> <fcltychartr>문예회관</fcltychartr> <sidonm>전북</sidonm> <gugunnm>군산시</gugunnm> <opende>2013</opende> </db> <db> <fcltynm>대전예술의전당</fcltynm> <mt10id>FC000076</mt10id> <mt13cnt>2</mt13cnt> <fcltychartr>문예회관</fcltychartr> <sidonm>대전</sidonm> <gugunnm>서구</gugunnm> <opende>2003</opende> </db> <db> <fcltynm>서귀포예술의전당</fcltynm> <mt10id>FC001231</mt10id> <mt13cnt>2</mt13cnt> <fcltychartr>문예회관</fcltychartr> <sidonm>제주</sidonm> <gugunnm>서귀포시</gugunnm> <opende>2014</opende> </db> </dbs> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 fcltynm 공연시설명 경주예술의전당 mt10id 공연시설ID FC000517 mt13cnt 공연장 수 2 fcltychartr 시설특성 문예회관 sidonm 지역(시도) 경북 gugunnm 지역(구군) 경주시 opende 개관연도 2010
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
기획/제작사목록
- 요청서비스
- 검색을 통한 기획/제작자 목록 서비스
※ 최대 100건까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/mnfct
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 cpage o 3 현재페이지 1 rows o 3 페이지당 목록 수 5 (최대 100건) entrpsnm x 100 기획/제작사 명 국악단(URLEncoding) shcate x 4 장르코드 AAAA afterdate x 8 해당일자 이후 등록/수정된 항목만 출력 20230101 - 요청/응답 메세지 예제
- 국악단으로 검색한 기획/제작사 목록을 1페이지 10개 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/mnfct?service={ServiceKey}&cpage=1&rows=10&entrpsnm=국악단
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <dbs> <db> <prfnm>청소년 여름 음악제, 서울시 청소년 국악관현악단</prfnm> <entrpsnm>서울시청소년국악단</entrpsnm> <genrenm>국악</genrenm> <telno> </telno> <relateurl> </relateurl> <mt30id>AG004248</mt30id> </db> <db> <prfnm> </prfnm> <entrpsnm>경남국악단</entrpsnm> <genrenm>국악</genrenm> <telno>055-297-0582</telno> <relateurl>-</relateurl> <mt30id>AG001712</mt30id> </db> <db> <prfnm> </prfnm> <entrpsnm>순천국악단</entrpsnm> <genrenm>국악</genrenm> <telno>011-611-8993</telno> <relateurl>cafe.daum.net/mirimkm/</relateurl> <mt30id>AG002076</mt30id> </db> <db> <prfnm>제2회 영재 국악회</prfnm> <entrpsnm>락음국악단</entrpsnm> <genrenm>국악</genrenm> <telno>031-829-0414</telno> <relateurl>http://www.rageum.org/</relateurl> <mt30id>AG002086</mt30id> </db> <db> <prfnm>필연: 황홀한만남, 자장자장 할머니가 들려주는 곰돌이의 여행 (6월)</prfnm> <entrpsnm>경기도립국악단</entrpsnm> <genrenm>국악</genrenm> <telno>031-289-6400</telno> <relateurl>http://gugak.ggac.or.kr</relateurl> <mt30id>AG001010</mt30id> </db> </dbs> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 prfnm 최신작품 제2회 영재 국악회 entrpsnm 기획/제작사명 락음국악단(URLEncoding) genrenm 장르 국악 telno 전화번호 031-829-0414 relateurl 홈페이지 http://www.rageum.org/ mt30id 기획/제작사ID AG002086
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
수상작 목록
- 요청서비스
- 검색을 통한 수상작 목록 서비스
※ 최대 100건까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfawad
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 공연시작일자 20160101 eddate o 8 공연종료일자 20160630 cpage o 3 현재페이지 1 rows o 3 페이지당 목록 수 10 (최대 100건) shprfnm x 100 공연명 사랑(URLEncoding) shprfnmfct x 100 공연시설명 예술의전당(URLEncoding) shcate x 4 장르코드 AAAA prfplccd x 4 공연장코드 FC000001-01 signgucode x 2 지역(시도)코드 11 signgucodesub x 4 지역(구군)코드 1111 kidstate x 1 아동공연여부 Y(지정안하면 기본은 전체공연) prfstate x 2 공연상태코드 01 afterdate x 8 해당일자 이후 등록/수정된 항목만 출력 20230101 - 요청/응답 메세지 예제
- 2023년06월01부터 2023년 06월 30일까지 공연중인 지역(시도)코드 11, 지역(구군)코드1111, 수상작 목록을 1페이지 10개 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfawad?service={SeriveKey}&stdate=20230601&eddate=20230630&cpage=1&rows=10&prfstate=02&signgucode=11&signgucodesub=1111
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?>
<dbs>
<db>
<mt20id>PF141135</mt20id>
<prfnm>다함께 다방구</prfnm>
<prfpdfrom>2017.08.01</prfpdfrom>
<prfpdto>2019.05.31</prfpdto>
<fcltynm>대학로 위로홀(구. 몬스터홀)</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF141135_180117_140527.jpg</poster>
<genrenm>뮤지컬</genrenm>
<prfstate>공연중</prfstate>
<awards>2017 대한민국 공감브랜드 대상 교육부문 대상</awards>
</db>
<db>
<mt20id>PF139762</mt20id>
<prfnm>사랑은 비를 타고</prfnm>
<prfpdfrom>2017.10.07</prfpdfrom>
<prfpdto>2019.05.31</prfpdto>
<fcltynm>예술극장 나무와물</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF139762_171011_095601.jpg</poster>
<genrenm>뮤지컬</genrenm>
<prfstate>공연중</prfstate>
<awards>제2회 1996 한국뮤지컬대상 남우주연상<br>제2회 1996 한국뮤지컬대상 여우조연상<br>제2회 1996 한국뮤지컬대상 연기상<br>제2회 1996 한국뮤지컬대상 작곡상</awards>
</db>
<db>
<mt20id>PF136878</mt20id>
<prfnm>오버코트</prfnm>
<prfpdfrom>2017.02.25</prfpdfrom>
<prfpdto>2019.06.29</prfpdto>
<fcltynm>라이트씨어터</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF136878_170407_163424.gif</poster>
<genrenm>연극</genrenm>
<prfstate>공연중</prfstate>
<awards>2017 아시테지 서울 어린이 연극상 대상<br>2017 아시테지 서울 어린이 연극상 연출상<br>2017 아시테지 서울 어린이 연극상 최고인기상</awards>
</db>
<db>
<mt20id>PF131898</mt20id>
<prfnm>김종욱 찾기</prfnm>
<prfpdfrom>2016.06.17</prfpdfrom>
<prfpdto>2019.07.14</prfpdto>
<fcltynm>컬처스페이스 엔유(구. 쁘티첼 씨어터)</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF131898_161020_104835.jpg</poster>
<genrenm>뮤지컬</genrenm>
<prfstate>공연중</prfstate>
<awards>제1회 더 뮤지컬 어워즈 남자조연상, 작사/극본상, 남자인기상, 여자인기상<br>제12회 한국뮤지컬대상 여우주연상, 남자인기상<br>제11회 대한민국 국회대상 올해의 뮤지컬상</awards>
</db>
</dbs>
- 출력결과 필드
-
출력결과 필드 변수명 설명 샘플데이터 mt20id 공연ID PF132236 prfnm 공연명 우리연애할까 prfpdfrom 공연시작일 2016.05.12 prfpdto 공연종료일 2016.07.31 fcltynm 공연시설명(공연장명) 피가로아트홀(구 훈아트홀) poster 포스터이미지경로 http://www.kopis.or.kr/upload/pfmPoster/PF_PF132236_160704_142630.gif genrenm 공연 장르명 연극 prfstate 공연상태 공연중 awards 수상실적 2017 대한민국 공감브랜드 대상 교육부문 대상
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
축제 목록
- 요청서비스
- 검색을 통한 축제 목록 서비스
※ 최대 100건까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prffest
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 공연시작일자 20160101 eddate o 8 공연종료일자 20160630 cpage o 3 현재페이지 1 rows o 3 페이지당 목록 수 10 (최대 100건) shprfnm x 100 공연명 사랑(URLEncoding) shprfnmfct x 100 공연시설명 예술의전당(URLEncoding) shcate x 4 장르코드 AAAA prfplccd x 4 공연장코드 FC000001-01 signgucode x 2 지역(시도)코드 11 signgucodesub x 4 지역(구군)코드 1111 kidstate x 1 아동공연여부 Y(지정안하면 기본은 전체공연) prfstate x 2 공연상태코드 01 afterdate x 8 해당일자 이후 등록/수정된 항목만 출력 20230101 - 요청/응답 메세지 예제
- 2023년06월01부터 2023년 06월 30일까지 공연중인 지역(시도)코드 11 축제 목록을 1페이지 10개 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prffest?service={SeriveKey}&stdate=20230601&eddate=20230630&cpage=1&rows=10
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <dbs> <db> <mt20id>PF233707</mt20id> <prfnm>제31회 젊은연극제, 한씨연대기 [청주]</prfnm> <prfpdfrom>2023.06.12</prfpdfrom> <prfpdto>2023.06.13</prfpdto> <fcltynm>공간아울</fcltynm> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF233707_240110_134155.jpg</poster> <genrenm>연극</genrenm> <festival>Y</festival> <prfstate>공연완료</prfstate> </db> <db> <mt20id>PF231245</mt20id> <prfnm>제962회 하우스콘서트, 줄라이 페스티벌 OPENING (7.1)</prfnm> <prfpdfrom>2023.07.01</prfpdfrom> <prfpdto>2023.07.01</prfpdto> <fcltynm>예술가의 집</fcltynm> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF231245_231128_173802.jpg</poster> <genrenm>서양음악(클래식)</genrenm> <festival>Y</festival> <prfstate>공연완료</prfstate> </db> <db> <mt20id>PF221640</mt20id> <prfnm>제주에서 펼쳐지는 뮤직 페스티벌, 매직클리프</prfnm> <prfpdfrom>2023.06.17</prfpdfrom> <prfpdto>2023.06.17</prfpdto> <fcltynm>더클리프</fcltynm> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF221640_230706_173246.jpg</poster> <genrenm>대중음악</genrenm> <festival>Y</festival> <prfstate>공연완료</prfstate> </db> <db> <mt20id>PF221466</mt20id> <prfnm>WORLD DJ FESTIVAL [서울]</prfnm> <prfpdfrom>2023.06.02</prfpdfrom> <prfpdto>2023.06.04</prfpdto> <fcltynm>서울랜드</fcltynm> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF221466_230705_105440.png</poster> <genrenm>대중음악</genrenm> <festival>Y</festival> <prfstate>공연완료</prfstate> </db> <db> <mt20id>PF221274</mt20id> <prfnm>제18회 부산국제매직페스티벌, 매직라운지: BIMF 매직컨벤션</prfnm> <prfpdfrom>2023.06.30</prfpdfrom> <prfpdto>2023.07.02</prfpdto> <fcltynm>(재)영화의전당</fcltynm> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF221274_230630_115459.jpg</poster> <genrenm>서커스/마술</genrenm> <festival>Y</festival> <prfstate>공연완료</prfstate> </db> </dbs>
- 출력결과 필드
-
출력결과 필드 변수명 설명 샘플데이터 mt20id 공연ID PF132236 prfnm 공연명 우리연애할까 prfpdfrom 공연시작일 2016.05.12 prfpdto 공연종료일 2016.07.31 fcltynm 공연시설명(공연장명) 피가로아트홀(구 훈아트홀) poster 포스터이미지경로 http://www.kopis.or.kr/upload/pfmPoster/PF_PF132236_160704_142630.gif genrenm 공연 장르명 연극 festival 축제여부 Y prfstate 공연상태 공연중
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
극작가 목록
- 요청서비스
- 검색을 통한 극작가 목록 서비스
※ 최대 100건까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfper
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 공연시작일자 20160101 eddate o 8 공연종료일자 20160630 cpage o 3 현재페이지 1 rows o 3 페이지당 목록 수 10 (최대 100건) shprfnm x 100 공연명 사랑(URLEncoding) shprfnmfct x 100 공연시설명 예술의전당(URLEncoding) shcate x 4 장르코드 AAAA prfplccd x 4 공연장코드 FC000001-01 signgucode x 2 지역(시도)코드 11 signgucodesub x 4 지역(구군)코드 1111 kidstate x 1 아동공연여부 Y(지정안하면 기본은 전체공연) prfstate x 2 공연상태코드 01 afterdate x 8 해당일자 이후 등록/수정된 항목만 출력 20230101 - 요청/응답 메세지 예제
- 2023년06월01부터 2023년 06월 30일까지 공연중인 극작가 목록을 1페이지 10개 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfper?service={SeriveKey}&stdate=20230601&eddate=20230630&cpage=1&rows=10&prfstate=02
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?>
<dbs>
<db>
<mt20id>PF146116</mt20id>
<prfnm>오 나의 귀신님</prfnm>
<prfpdfrom>2019.01.10</prfpdfrom>
<prfpdto>2019.05.31</prfpdto>
<fcltynm>낙산씨어터</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF146116_190114_102229.jpg</poster>
<genrenm>연극</genrenm>
<prfstate>공연중</prfstate>
<author>김우경</author>
</db>
<db>
<mt20id>PF145107</mt20id>
<prfnm>보잉보잉</prfnm>
<prfpdfrom>2018.11.01</prfpdfrom>
<prfpdto>2019.05.31</prfpdto>
<fcltynm>대학로 두레홀 3관</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF145107_181026_095335.gif</poster>
<genrenm>연극</genrenm>
<prfstate>공연중</prfstate>
<author>마르끄 까몰레띠</author>
<creator>손남목(각색)</creator>
</db>
<db>
<mt20id>PF144982</mt20id>
<prfnm>택시안에서</prfnm>
<prfpdfrom>2018.10.12</prfpdfrom>
<prfpdto>2019.06.30</prfpdto>
<fcltynm>해바라기소극장(구. 훈아트홀)</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF144982_181017_114924.jpg</poster>
<genrenm>연극</genrenm>
<prfstate>공연중</prfstate>
<author>이규인</author>
</db>
<db>
<mt20id>PF144112</mt20id>
<prfnm>오백에 삼십 [아트포레스트]</prfnm>
<prfpdfrom>2018.09.04</prfpdfrom>
<prfpdto>2019.06.30</prfpdto>
<fcltynm>아트포레스트 아트홀</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF144112_180820_093814.gif</poster>
<genrenm>연극</genrenm>
<prfstate>공연중</prfstate>
<author>박아정</author>
</db>
<db>
<mt20id>PF142539</mt20id>
<prfnm>나의PS파트너</prfnm>
<prfpdfrom>2018.03.08</prfpdfrom>
<prfpdto>2019.05.31</prfpdto>
<fcltynm>마루아트홀</fcltynm>
<poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF142539_180423_132324.jpg</poster>
<genrenm>연극</genrenm>
<prfstate>공연중</prfstate>
<author>김민수, 변성현</author>
<creator>정세혁(각색)</creator>
</db>
</dbs>
- 출력결과 필드
-
출력결과 필드 변수명 설명 샘플데이터 mt20id 공연ID PF132236 prfnm 공연명 우리연애할까 prfpdfrom 공연시작일 2016.05.12 prfpdto 공연종료일 2016.07.31 fcltynm 공연시설명(공연장명) 피가로아트홀(구 훈아트홀) poster 포스터이미지경로 http://www.kopis.or.kr/upload/pfmPoster/PF_PF132236_160704_142630.gif genrenm 공연 장르명 연극 prfstate 공연상태 공연중 author 원작자 김민수, 변성현 creator 창작자 정세혁(각색)
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
예매상황판
- 요청서비스
- 검색을 통한 예매상황판 서비스
※ 전체, 장르별(연극, 뮤지컬, 클래식, 오페라, 무용, 국악, 복합), 특성별(오픈런, 아동) 각 최대 50개까지 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/boxoffice
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 시작일자 20230601 eddate o 8 종료일자 20230630 (최대 31일) catecode x 9 장르 구분 코드(예매상황판용) AAAA area x 5 지역 코드(예매상황판용) 11 srchseatscale x 5 좌석수 0(미상), 100(1~300석 미만), 300(300~500석 미만)
,500(500~1000석 미만), 1000(1000~5000석 미만)
,5000(5000~10000석 미만), 10000(10000석 이상)- 요청/응답 메세지 예제
- 장르 AAAA, 지역11 인 주별 예매상황판 목록 요청
- -요청 URL
- http://kopis.or.kr/openApi/restful/boxoffice?service={ServiceKey}&stdate=20230601&eddate=20230630&catecode=AAAA&area=11&srchseatscale=100
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <boxofs> <boxof> <prfplcnm>티오엠씨어터(구. 문화공간필링) 2관</prfplcnm> <seatcnt>220</seatcnt> <rnum>8</rnum> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF217129_230420_112243.gif</poster> <prfpd>2023.05.17~2023.06.25</prfpd> <mt20id>PF217129</mt20id> <prfnm>온 더 비트</prfnm> <cate>연극</cate> <prfdtcnt>0</prfdtcnt> <area>서울</area> </boxof> <boxof> <prfplcnm>링크아트센터드림 드림 2관</prfplcnm> <seatcnt>211</seatcnt> <rnum>9</rnum> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF216047_230331_154426.gif</poster> <prfpd>2023.04.23~2023.06.18</prfpd> <mt20id>PF216047</mt20id> <prfnm>폭풍의 언덕</prfnm> <cate>연극</cate> <prfdtcnt>0</prfdtcnt> <area>서울</area> </boxof> <boxof> <prfplcnm>예그린씨어터 예그린씨어터</prfplcnm> <seatcnt>202</seatcnt> <rnum>10</rnum> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF218343_230602_081533.gif</poster> <prfpd>2023.06.16~2023.07.16</prfpd> <mt20id>PF218343</mt20id> <prfnm>세일즈맨의 죽음</prfnm> <cate>연극</cate> <prfdtcnt>0</prfdtcnt> <area>서울</area> </boxof> </boxofs> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 boxof prfplcnm 공연장 티오엠씨어터(구. 문화공간필링) 2관 seatcnt 좌석수 220 rnum 순위 8 poster 포스터이미지 http://www.kopis.or.kr/upload/pfmPoster/PF_PF217129_230420_112243.gif prfpd 공연기간 2023.05.17~2023.06.25 mt20id 공연ID PF217129 prfnm 공연명 온 더 비트 cate 장르 연극 prfdtcnt 상연횟수 0 area 지역 서울
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
공연목록
- 요청서비스
- 검색을 통한 공연 목록 서비스
※ 최대 100건까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/pblprfr
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 공연시작일자 20230101 eddate o 8 공연종료일자 20230630 cpage o 3 현재페이지 1 rows o 3 페이지당 목록 수 10 (최대 100건) shprfnm x 100 공연명 사랑(URLEncoding) shprfnmfct x 100 공연시설명 예술의전당(URLEncoding) shcate x 4 장르코드 AAAA prfplccd x 4 공연장코드 FC000001-01 signgucode x 2 지역(시도)코드 11 signgucodesub x 4 지역(구군)코드 1111 kidstate x 1 아동공연여부 Y(지정안하면 기본은 전체공연) prfstate x 2 공연상태코드 01 openrun x 2 오픈런 Y afterdate x 8 해당일자 이후 등록/수정된 항목만 출력 20230101 - 요청/응답 메세지 예제
- 2023년06월01부터 2023년 06월 30일까지 공연중인 지역(시도)코드 11, 지역(구군)코드1111, 아동공연의 공연 목록을 1페이지 10개 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/pblprfr?service={SeriveKey}&stdate=20230601&eddate=20230630&cpage=1&rows=10&prfstate=02&signgucode=11&signgucodesub=1111&kidstate=Y
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <dbs> <db> <mt20id>PF178134</mt20id> <prfnm>반짝반짝 인어공주</prfnm> <prfpdfrom>2021.08.21</prfpdfrom> <prfpdto>2024.09.29</prfpdto> <fcltynm>달밤엔씨어터</fcltynm> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF178134_210809_125033.PNG</poster> <area>서울특별시</area> <genrenm>뮤지컬</genrenm> <openrun>Y</openrun> <prfstate>공연중</prfstate> </db> <db> <mt20id>PF152141</mt20id> <prfnm>북극곰 예술여행</prfnm> <prfpdfrom>2019.07.20</prfpdfrom> <prfpdto>2024.09.29</prfpdto> <fcltynm>북극곰소극장(구.아뮤스소극장)</fcltynm> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF152141_190724_140737.jpg</poster> <area>서울특별시</area> <genrenm>연극</genrenm> <openrun>Y</openrun> <prfstate>공연중</prfstate> </db> <db> <mt20id>PF151901</mt20id> <prfnm>요리하는 마술사 [대학로]</prfnm> <prfpdfrom>2019.06.29</prfpdfrom> <prfpdto>2024.10.06</prfpdto> <fcltynm>맛있는 극장</fcltynm> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF151901_190719_134111.gif</poster> <area>서울특별시</area> <genrenm>서커스/마술</genrenm> <openrun>Y</openrun> <prfstate>공연중</prfstate> </db> </dbs> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 mt20id 공연ID PF178134 prfnm 공연명 반짝반짝 인어공주 prfpdfrom 공연시작일 2021.08.21 prfpdto 공연종료일 2024.09.29 fcltynm 공연시설명(공연장명) 달밤엔씨어터 poster 포스터이미지경로 http://www.kopis.or.kr/upload/pfmPoster/PF_PF178134_210809_125033.PNG area 공연지역 서울특별시 genrenm 공연 장르명 뮤지컬 openrun 오픈런 Y prfstate 공연상태 공연중
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
공연상세
- 요청서비스
- 검색을 통한 공연상세 목록 서비스
- 요청 URL
- http://kopis.or.kr/openApi/restful/pblprfr/{공연아이디}
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 mt20id o 8 공연목록 조회 후 나오는 공연ID 참조 PF132236 - 요청/응답 메세지 예제
- 2016년06월01부터 2016년 06월 30일까지 공연중인 지역(시도)코드 11, 지역(구군)코드1111, 아동공연의 공연 목록을 1페이지 5개 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/pblprfr/PF132236?service={SeriveKey}
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"? <dbs> <db> <mt20id>PF132236</mt20id> <prfnm>우리 연애할까?</prfnm> <prfpdfrom>2016.05.12</prfpdfrom> <prfpdto>2016.12.31</prfpdto> <fcltynm>해바라기소극장(구. 훈아트홀) (해바라기소극장(구. 훈아트홀))</fcltynm> <prfcast>김세연, 신성진, 정재연, 전다정, 장보경, 최민기</prfcast> <prfcrew>천정민</prfcrew> <prfruntime>1시간 30분</prfruntime> <prfage>만 12세 이상</prfage> <entrpsnm>극단 피에로(문화제작소)</entrpsnm> <entrpsnmP>극단 피에로(문화제작소)</entrpsnmP> <entrpsnmA> </entrpsnmA> <entrpsnmH> </entrpsnmH> <entrpsnmS> </entrpsnmS> <pcseguidance>전석 30,000원</pcseguidance> <poster>http://www.kopis.or.kr/upload/pfmPoster/PF_PF132236_161107_144405.gif</poster> <sty> </sty> <area>서울특별시</area> <genrenm>연극</genrenm> <openrun>N</openrun> <visit>N</visit> <child>N</child> <daehakro>Y</daehakro> <festival>N</festival> <musicallicense>N</musicallicense> <musicalcreate>N</musicalcreate> <updatedate>2019-07-25 10:03:14</updatedate> <prfstate>공연완료</prfstate> <styurls> <styurl>http://www.kopis.or.kr/upload/pfmIntroImage/PF_PF132236_161107_0245254.jpg</styurl> <styurl>http://www.kopis.or.kr/upload/pfmIntroImage/PF_PF132236_161107_0245253.jpg</styurl> <styurl>http://www.kopis.or.kr/upload/pfmIntroImage/PF_PF132236_161107_0245252.jpg</styurl> <styurl>http://www.kopis.or.kr/upload/pfmIntroImage/PF_PF132236_161107_0245251.jpg</styurl> </styurls> <mt10id>FC001431</mt10id> <dtguidance>화요일 ~ 금요일(20:00), 토요일(15:00,17:30,20:00), 일요일(15:30,18:00)</dtguidance> <relates> <relate> <relatenm>대학로티켓닷컴</relatenm> <relateurl>http://www.대학로티켓.com/univticket/tuniv/ccontents/view.do?rbsIdx=27&contentsCode=20160925003</relateurl> </relate> <relate> <relatenm>티켓링크</relatenm> <relateurl>http://www.ticketlink.co.kr/product/14015</relateurl> </relate> <relate> <relateurl>http://www.playticket.co.kr/ticketDetail.html?idx=266</relateurl> </relate> </relates> </db> </dbs> - 출력결과 필드
-
출력결과 필드 변수명 필드 설명 샘플데이터 mt20id 공연ID PF132236 prfnm 공연명 우리 연애할까? prfpdfrom 공연시작일 2016.05.12 prfpdto 공연종료일 2016.12.31 fcltynm 공연시설명(공연장명) 피가로아트홀(구 훈아트홀) (피가로아트홀) prfcast 공연출연진 김부연, 임정균, 최수영 prfcrew 공연제작진 천정민 prfruntime 공연 런타임 1시간 30분 prfage 공연 관람 연령 만 12세 이상 entrpsnm 기획제작사 극단 피에로(문화제작소) entrpsnmP 제작사 극단 피에로(문화제작소) entrpsnmA 기획사 entrpsnmH 주최 entrpsnmS 주관 pcseguidance 티켓가격 전석 30,000원 poster 포스터이미지경로 http://www.kopis.or.kr/upload/pfmPoster/PF_PF132236_160704_142630.gif sty 줄거리 area 지역 서울특별시 genrenm 장르 연극 openrun 오픈런 Y visit 내한 N child 아동 N daehakro 대학로 Y festival 축제 N musicallicense 뮤지컬 라이센스 N musicalcreate 뮤지컬 창작 N updatedate 최종수정일 2019-07-25 10:03:14 prfstate 공연상태 공연중 styurls 소개이미지목록 styurl 소개이미지1 http://www.kopis.or.kr/upload/pfmIntroImage/PF_PF132236_160704_0226303.jpg styurl 소개이미지2 http://www.kopis.or.kr/upload/pfmIntroImage/PF_PF132236_160704_0226302.jpg styurl 소개이미지3 http://www.kopis.or.kr/upload/pfmIntroImage/PF_PF132236_160704_0226301.jpg styurl 소개이미지4 http://www.kopis.or.kr/upload/pfmIntroImage/PF_PF132236_160704_0226300.jpg mt10id 공연시설ID FC001431 dtguidance 공연시간 화요일 ~ 금요일(20:00), 토요일(16:00,19:00), 일요일(15:00,18:00) relates 예매처목록 relatenm 예매처명1 대학로티켓닷컴 relateurl 예매처URL1 http://www.대학로티켓.com/univticket/tuniv/ccontents/view.do?rbsIdx=27&contentsCode=20160925003 relatenm 예매처명2 티켓링크 relateurl 예매처URL2 http://www.ticketlink.co.kr/product/14015 relateurl 예매처URL3 http://www.playticket.co.kr/ticketDetail.html?idx=266
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR
공연시설상세
- 요청서비스
- 검색을 통한 공연시설 상세 목록 서비스
- 요청 URL
- http://kopis.or.kr/openApi/restful/prfplc/{공연시설아이디}
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 mt10id o 8 공연시설목록 조회 후 나오는 공연시설ID 참조 FC001247 - 요청/응답 메세지 예제
- 2016년도 6월에 대한 지역별 통계 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfplc/FC001247?service={ServiceKey}
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <dbs> <db> <fcltynm>올림픽공원</fcltynm> <mt10id>FC001247</mt10id> <mt13cnt>11</mt13cnt> <fcltychartr>공공(기타)</fcltychartr> <opende>1986</opende> <seatscale>41356</seatscale> <telno>02-410-1114</telno> <relateurl>http://www.olympicpark.co.kr/</relateurl> <adres>서울특별시 송파구 올림픽로 424 올림픽공원 (방이동)</adres> <la>37.52112</la> <lo>127.12836360000005</lo> <restaurant>Y</restaurant> <cafe>Y</cafe> <store>Y</store> <nolibang>N</nolibang> <suyu>N</suyu> <parkbarrier>N</parkbarrier> <restbarrier>N</restbarrier> <runwbarrier>N</runwbarrier> <elevbarrier>N</elevbarrier> <parkinglot>Y</parkinglot> <mt13s> <mt13> <prfplcnm>KSPO DOME(체조경기장)</prfplcnm> <mt13id>FC001247-01</mt13id> <seatscale>15,000</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> </mt13> <mt13> <prfplcnm>SK핸드볼경기장(펜싱경기장)</prfplcnm> <mt13id>FC001247-02</mt13id> <seatscale>5,003</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> <disabledseatscale>20</disabledseatscale> </mt13> <mt13> <prfplcnm>올림픽홀</prfplcnm> <mt13id>FC001247-03</mt13id> <seatscale>2,432</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> <disabledseatscale>22</disabledseatscale> <stagearea>23.1X18.5X8.5</stagearea> </mt13> <mt13> <prfplcnm>뮤즈라이브</prfplcnm> <mt13id>FC001247-04</mt13id> <seatscale>237</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> <disabledseatscale>3</disabledseatscale> </mt13> <mt13> <prfplcnm>우리금융아트홀(역도경기장)</prfplcnm> <mt13id>FC001247-05</mt13id> <seatscale>1,184</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> <disabledseatscale>12</disabledseatscale> <stagearea>15.8X13.3X8.7</stagearea> </mt13> <mt13> <prfplcnm>K-아트홀</prfplcnm> <mt13id>FC001247-06</mt13id> <seatscale>500</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> </mt13> <mt13> <prfplcnm>야외(88잔디마당)</prfplcnm> <mt13id>FC001247-07</mt13id> <seatscale>10,000</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> </mt13> <mt13> <prfplcnm>야외(수변무대)</prfplcnm> <mt13id>FC001247-08</mt13id> <seatscale>1,000</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> </mt13> <mt13> <prfplcnm>벨로드롬(경륜경기장)</prfplcnm> <mt13id>FC001247-09</mt13id> <seatscale>6,000</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> </mt13> <mt13> <prfplcnm>평화광장</prfplcnm> <mt13id>FC001247-11</mt13id> <seatscale>0</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> </mt13> <mt13> <prfplcnm>일대</prfplcnm> <mt13id>FC001247-12</mt13id> <seatscale>0</seatscale> <stageorchat>N</stageorchat> <stagepracat>Y</stagepracat> <stagedresat>Y</stagedresat> <stageoutdrat>N</stageoutdrat> </mt13> </mt13s> </db> </dbs> - 출력결과 필드
-
출력결과 필드 필드명 필드 설명 샘플데이터 fcltynm 공연시설명 올림픽공원 mt10id 공연시설ID FC001247 mt13cnt 공연장 수 9 fcltychartr 시설특성 기타(공공) opende 개관연도 1986 seatscale 객석 수 32349 telno 전화번호 02-410-1114 relateurl 홈페이지 http://www.olympicpark.co.kr/ adres 주소 서울특별시 송파구 올림픽로 424 올림픽공원 (방이동) la 위도 37.52112 lo 경도 127.12836360000005 restaurant 레스토랑 Y cafe 카페 Y store 편의점 Y nolibang 놀이방 N suyu 수유실 N parkbarrier 장애시설-주차장 N restbarrier 장애시설-화장실 N runwbarrier 장애시설-경사로 N elevbarrier 장애시설-엘리베이터 N parkinglot 주차시설 Y mt13s 공연장목록 prfplcnm 공연장명 KSPO DOME(체조경기장) mt13id MT13_ID(고유식별ID) FC001247-01 seatscale 좌석규모 15,000 stageorchat 무대시설_오케스트라피트(Y/N/Z/0) N stagepracat 무대시설_연습실 Y stagedresat 무대시설_분장실 Y stageoutdrat 무대시설_야외공연장 N disabledseatscale 장애인시설_관객석(N/000) 20 stagearea 무대시설_무대넓이(000/0X0/00.00) 15.8X13.3X8.7
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR
기간별 통계
- 요청서비스
- 검색을 통한 예매통계 기간별 데이터 제공 서비스
※ 요일별은 7일, 일별은 31일까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/boxStats
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 ststype o 5 요청 형태 day(일별)dayWeek(주별)＊조회기간은 일별/주별 동일하게 최대 31일이며,주별 요청시 요일별 기준으로 합계되어 표기 stdate o 8 시작날짜 20230108 eddate o 8 종료날짜 20230112 (최대 31일) - 요청/응답 메세지 예제
- 2023년 01월 08일부터 2023년 01월 12일까지 예매통계 목록 요청
- -요청 URL
- http://kopis.or.kr/openApi/restful/boxStats?service={ServiceKey}&stdate=20230108&eddate=20230112&ststype=day
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <box-statsofs> <boxStatsof> <prfdt>2023-01-08</prfdt> <prfcnt>1058</prfcnt> <prfdtcnt>4600</prfdtcnt> <ntssnmrssm>53253</ntssnmrssm> <cancelnmrssm>20682</cancelnmrssm> <totnmrssm>32571</totnmrssm> <ntssamountsm>1973067860</ntssamountsm> </boxStatsof> <boxStatsof> <prfdt>2023-01-09</prfdt> <prfcnt>1103</prfcnt> <prfdtcnt>4861</prfdtcnt> <ntssnmrssm>76297</ntssnmrssm> <cancelnmrssm>28881</cancelnmrssm> <totnmrssm>47416</totnmrssm> <ntssamountsm>2752341520</ntssamountsm> </boxStatsof> <boxStatsof> <prfdt>2023-01-10</prfdt> <prfcnt>1172</prfcnt> <prfdtcnt>5247</prfdtcnt> <ntssnmrssm>88566</ntssnmrssm> <cancelnmrssm>39003</cancelnmrssm> <totnmrssm>49563</totnmrssm> <ntssamountsm>2654973216</ntssamountsm> </boxStatsof> <boxStatsof> <prfdt>2023-01-11</prfdt> <prfcnt>1203</prfcnt> <prfdtcnt>5380</prfdtcnt> <ntssnmrssm>105390</ntssnmrssm> <cancelnmrssm>35486</cancelnmrssm> <totnmrssm>69904</totnmrssm> <ntssamountsm>3415455960</ntssamountsm> </boxStatsof> <boxStatsof> <prfdt>2023-01-12</prfdt> <prfcnt>1212</prfcnt> <prfdtcnt>5345</prfdtcnt> <ntssnmrssm>87652</ntssnmrssm> <cancelnmrssm>29636</cancelnmrssm> <totnmrssm>58016</totnmrssm> <ntssamountsm>3018542370</ntssamountsm> </boxStatsof> <boxStatsof> <prfdt>합계</prfdt> <prfcnt>5748</prfcnt> <prfdtcnt>25433</prfdtcnt> <ntssnmrssm>411158</ntssnmrssm> <cancelnmrssm>153688</cancelnmrssm> <totnmrssm>257470</totnmrssm> <ntssamountsm>13814380926</ntssamountsm> </boxStatsof> </box-statsofs> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 boxStatsof prfdt 날짜 2023-01-08 prfcnt 공연건수 1058 prfdtcnt 공연횟수 4600 ntssnmrssm 예매수 53253 cancelnmrssm 취소수 20682 totnmrssm 총 티켓판매수 32571 ntssamountsm 총 티켓판매액 1973067860
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
장르별 통계
- 요청서비스
- 검색을 통한 예매통계 장르별 데이터 제공 서비스
※ 최대 31일까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/boxStatsCate
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 시작날짜 20230108 eddate o 8 종료날짜 20230112 (최대 31일) catecode x 30 장르 구분 코드 AAAA|BBBC|CCCA - 요청/응답 메세지 예제
- 2023년 01월 08일부터 2023년 01월 12일까지 예매통계 목록 요청
- -요청 URL
- http://kopis.or.kr/openApi/restful/boxStatsCate?service={ServiceKey}&stdate=20230108&eddate=20230112&catecode=AAAA
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <box-statsofs> <boxStatsof> <catenm>연극</catenm> <prfcnt>190</prfcnt> <prfdtcnt>2673</prfdtcnt> <ntssnmrssm>76368</ntssnmrssm> <cancelnmrssm>19093</cancelnmrssm> <totnmrssm>57275</totnmrssm> <ntssamountsm>1498396090</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>합계</catenm> <prfcnt>190</prfcnt> <prfdtcnt>2673</prfdtcnt> <ntssnmrssm>76368</ntssnmrssm> <cancelnmrssm>19093</cancelnmrssm> <totnmrssm>57275</totnmrssm> <ntssamountsm>1498396090</ntssamountsm> </boxStatsof> </box-statsofs> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 boxStatsof catenm 장르 연극 prfcnt 공연건수 190 prfdtcnt 상연횟수 2673 ntssnmrssm 예매수 76368 cancelnmrssm 취소수 19093 totnmrssm 총 티켓판매수 57275 ntssamountsm 총 티켓판매액 1498396090
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
시간대별 통계
- 요청서비스
- 검색을 통한 예매통계 시간대별 데이터 제공 서비스
※ 최대 31일까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/boxStatsTime
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 시작날짜 20230108 eddate o 8 종료날짜 20230112 (최대 31일) - 요청/응답 메세지 예제
- 2023년 01월 08일부터 2023년 01월 12일까지 예매통계 목록 요청
- -요청 URL
- http://kopis.or.kr/openApi/restful/boxStatsTime?service={ServiceKey}&stdate=20230108&eddate=20230112
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <box-statsofs> <boxStatsof> <timename>00:00 ~ 2:59</timename> <prfcnt>16</prfcnt> <prfdtcnt>16</prfdtcnt> <ntssnmrssm>82</ntssnmrssm> <cancelnmrssm>23</cancelnmrssm> <totnmrssm>59</totnmrssm> <ntssamountsm>-989500</ntssamountsm> </boxStatsof> <boxStatsof> <timename>3:00 ~ 5:59</timename> <prfcnt>0</prfcnt> <prfdtcnt>0</prfdtcnt> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <timename>6:00 ~ 8:59</timename> <prfcnt>1</prfcnt> <prfdtcnt>1</prfdtcnt> <ntssnmrssm>28</ntssnmrssm> <cancelnmrssm>32</cancelnmrssm> <totnmrssm>-4</totnmrssm> <ntssamountsm>-616000</ntssamountsm> </boxStatsof> <boxStatsof> <timename>9:00 ~ 11:59</timename> <prfcnt>1181</prfcnt> <prfdtcnt>1181</prfdtcnt> <ntssnmrssm>35604</ntssnmrssm> <cancelnmrssm>13504</cancelnmrssm> <totnmrssm>22100</totnmrssm> <ntssamountsm>630984990</ntssamountsm> </boxStatsof> <boxStatsof> <timename>12:00 ~ 14:59</timename> <prfcnt>2239</prfcnt> <prfdtcnt>2239</prfdtcnt> <ntssnmrssm>96716</ntssnmrssm> <cancelnmrssm>38691</cancelnmrssm> <totnmrssm>58025</totnmrssm> <ntssamountsm>3466686046</ntssamountsm> </boxStatsof> <boxStatsof> <timename>15:00 ~ 17:59</timename> <prfcnt>2192</prfcnt> <prfdtcnt>2192</prfdtcnt> <ntssnmrssm>89967</ntssnmrssm> <cancelnmrssm>25221</cancelnmrssm> <totnmrssm>64746</totnmrssm> <ntssamountsm>2887466050</ntssamountsm> </boxStatsof> <boxStatsof> <timename>18:00 ~ 20:59</timename> <prfcnt>2751</prfcnt> <prfdtcnt>2751</prfdtcnt> <ntssnmrssm>188569</ntssnmrssm> <cancelnmrssm>76155</cancelnmrssm> <totnmrssm>112414</totnmrssm> <ntssamountsm>6828223340</ntssamountsm> </boxStatsof> <boxStatsof> <timename>21:00 ~ 23:59</timename> <prfcnt>22</prfcnt> <prfdtcnt>22</prfdtcnt> <ntssnmrssm>192</ntssnmrssm> <cancelnmrssm>62</cancelnmrssm> <totnmrssm>130</totnmrssm> <ntssamountsm>2626000</ntssamountsm> </boxStatsof> <boxStatsof> <timename>합계</timename> <prfcnt>8402</prfcnt> <prfdtcnt>8402</prfdtcnt> <ntssnmrssm>411158</ntssnmrssm> <cancelnmrssm>153688</cancelnmrssm> <totnmrssm>257470</totnmrssm> <ntssamountsm>13814380926</ntssamountsm> </boxStatsof> </box-statsofs> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 boxStatsof timename 시간대 00:00 ~ 2:59 prfcnt 공연건수 16 prfdtcnt 공연횟수 16 ntssnmrssm 예매수 82 cancelnmrssm 취소수 23 totnmrssm 총 티켓판매수 59 ntssamountsm 총 티켓판매액 -989500
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
가격대별 통계
- 요청서비스
- 검색을 통한 예매통계 가격대별 데이터 제공 서비스
※ 최대 31일까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/boxStatsPrice
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 시작날짜 20230108 eddate o 8 종료날짜 20230112 (최대 31일) - 요청/응답 메세지 예제
- 2023년 01월 08일부터 2023년 01월 12일까지 예매통계 목록 요청
- -요청 URL
- http://kopis.or.kr/openApi/restful/boxStatsPrice?service={ServiceKey}&stdate=20230108&eddate=20230112
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <box-statsofs> <boxStatsof> <catenm>연극</catenm> <price>0원</price> <ntssnmrssm>16861</ntssnmrssm> <cancelnmrssm>7366</cancelnmrssm> <totnmrssm>9495</totnmrssm> <pertotnmrssm>17</pertotnmrssm> <ntssamountsm>75848000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>연극</catenm> <price>3만원미만</price> <ntssnmrssm>37021</ntssnmrssm> <cancelnmrssm>4231</cancelnmrssm> <totnmrssm>32790</totnmrssm> <pertotnmrssm>57</pertotnmrssm> <ntssamountsm>507277320</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>연극</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>10368</ntssnmrssm> <cancelnmrssm>3258</cancelnmrssm> <totnmrssm>7110</totnmrssm> <pertotnmrssm>12</pertotnmrssm> <ntssamountsm>269986670</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>연극</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>4021</ntssnmrssm> <cancelnmrssm>1732</cancelnmrssm> <totnmrssm>2289</totnmrssm> <pertotnmrssm>4</pertotnmrssm> <ntssamountsm>131679600</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>연극</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>4992</ntssnmrssm> <cancelnmrssm>1542</cancelnmrssm> <totnmrssm>3450</totnmrssm> <pertotnmrssm>6</pertotnmrssm> <ntssamountsm>280668100</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>연극</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>3105</ntssnmrssm> <cancelnmrssm>964</cancelnmrssm> <totnmrssm>2141</totnmrssm> <pertotnmrssm>4</pertotnmrssm> <ntssamountsm>232936400</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>연극</catenm> <price>15만원이상</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>무용(서양/한국무용)</catenm> <price>0원</price> <ntssnmrssm>649</ntssnmrssm> <cancelnmrssm>5</cancelnmrssm> <totnmrssm>644</totnmrssm> <pertotnmrssm>12</pertotnmrssm> <ntssamountsm>1080000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>무용(서양/한국무용)</catenm> <price>3만원미만</price> <ntssnmrssm>1392</ntssnmrssm> <cancelnmrssm>316</cancelnmrssm> <totnmrssm>1076</totnmrssm> <pertotnmrssm>20</pertotnmrssm> <ntssamountsm>19959000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>무용(서양/한국무용)</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>1740</ntssnmrssm> <cancelnmrssm>249</cancelnmrssm> <totnmrssm>1491</totnmrssm> <pertotnmrssm>27</pertotnmrssm> <ntssamountsm>52665000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>무용(서양/한국무용)</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>815</ntssnmrssm> <cancelnmrssm>206</cancelnmrssm> <totnmrssm>609</totnmrssm> <pertotnmrssm>11</pertotnmrssm> <ntssamountsm>34789000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>무용(서양/한국무용)</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>681</ntssnmrssm> <cancelnmrssm>220</cancelnmrssm> <totnmrssm>461</totnmrssm> <pertotnmrssm>8</pertotnmrssm> <ntssamountsm>34977000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>무용(서양/한국무용)</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>538</ntssnmrssm> <cancelnmrssm>103</cancelnmrssm> <totnmrssm>435</totnmrssm> <pertotnmrssm>8</pertotnmrssm> <ntssamountsm>52452000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>무용(서양/한국무용)</catenm> <price>15만원이상</price> <ntssnmrssm>992</ntssnmrssm> <cancelnmrssm>241</cancelnmrssm> <totnmrssm>751</totnmrssm> <pertotnmrssm>14</pertotnmrssm> <ntssamountsm>149896000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중무용</catenm> <price>0원</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중무용</catenm> <price>3만원미만</price> <ntssnmrssm>10</ntssnmrssm> <cancelnmrssm>1</cancelnmrssm> <totnmrssm>9</totnmrssm> <pertotnmrssm>20</pertotnmrssm> <ntssamountsm>180000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중무용</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>44</ntssnmrssm> <cancelnmrssm>9</cancelnmrssm> <totnmrssm>35</totnmrssm> <pertotnmrssm>80</pertotnmrssm> <ntssamountsm>1050000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중무용</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중무용</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중무용</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중무용</catenm> <price>15만원이상</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서양음악(클래식)</catenm> <price>0원</price> <ntssnmrssm>7413</ntssnmrssm> <cancelnmrssm>1199</cancelnmrssm> <totnmrssm>6214</totnmrssm> <pertotnmrssm>21</pertotnmrssm> <ntssamountsm>10180000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서양음악(클래식)</catenm> <price>3만원미만</price> <ntssnmrssm>13512</ntssnmrssm> <cancelnmrssm>3371</cancelnmrssm> <totnmrssm>10141</totnmrssm> <pertotnmrssm>35</pertotnmrssm> <ntssamountsm>146499440</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서양음악(클래식)</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>5909</ntssnmrssm> <cancelnmrssm>1472</cancelnmrssm> <totnmrssm>4437</totnmrssm> <pertotnmrssm>15</pertotnmrssm> <ntssamountsm>165432200</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서양음악(클래식)</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>3024</ntssnmrssm> <cancelnmrssm>825</cancelnmrssm> <totnmrssm>2199</totnmrssm> <pertotnmrssm>8</pertotnmrssm> <ntssamountsm>121320700</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서양음악(클래식)</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>3155</ntssnmrssm> <cancelnmrssm>914</cancelnmrssm> <totnmrssm>2241</totnmrssm> <pertotnmrssm>8</pertotnmrssm> <ntssamountsm>179733250</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서양음악(클래식)</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>2953</ntssnmrssm> <cancelnmrssm>1043</cancelnmrssm> <totnmrssm>1910</totnmrssm> <pertotnmrssm>7</pertotnmrssm> <ntssamountsm>217961200</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서양음악(클래식)</catenm> <price>15만원이상</price> <ntssnmrssm>2074</ntssnmrssm> <cancelnmrssm>215</cancelnmrssm> <totnmrssm>1859</totnmrssm> <pertotnmrssm>6</pertotnmrssm> <ntssamountsm>332818500</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>한국음악(국악)</catenm> <price>0원</price> <ntssnmrssm>2267</ntssnmrssm> <cancelnmrssm>669</cancelnmrssm> <totnmrssm>1598</totnmrssm> <pertotnmrssm>39</pertotnmrssm> <ntssamountsm>17200000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>한국음악(국악)</catenm> <price>3만원미만</price> <ntssnmrssm>3274</ntssnmrssm> <cancelnmrssm>1047</cancelnmrssm> <totnmrssm>2227</totnmrssm> <pertotnmrssm>54</pertotnmrssm> <ntssamountsm>31669450</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>한국음악(국악)</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>344</ntssnmrssm> <cancelnmrssm>148</cancelnmrssm> <totnmrssm>196</totnmrssm> <pertotnmrssm>5</pertotnmrssm> <ntssamountsm>6692000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>한국음악(국악)</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>90</ntssnmrssm> <cancelnmrssm>20</cancelnmrssm> <totnmrssm>70</totnmrssm> <pertotnmrssm>2</pertotnmrssm> <ntssamountsm>3550000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>한국음악(국악)</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>4</ntssnmrssm> <cancelnmrssm>1</cancelnmrssm> <totnmrssm>3</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>240000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>한국음악(국악)</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>1</ntssnmrssm> <cancelnmrssm>1</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>한국음악(국악)</catenm> <price>15만원이상</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중음악</catenm> <price>0원</price> <ntssnmrssm>4902</ntssnmrssm> <cancelnmrssm>1397</cancelnmrssm> <totnmrssm>3505</totnmrssm> <pertotnmrssm>10</pertotnmrssm> <ntssamountsm>99044000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중음악</catenm> <price>3만원미만</price> <ntssnmrssm>9083</ntssnmrssm> <cancelnmrssm>282</cancelnmrssm> <totnmrssm>8801</totnmrssm> <pertotnmrssm>25</pertotnmrssm> <ntssamountsm>97639300</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중음악</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>870</ntssnmrssm> <cancelnmrssm>237</cancelnmrssm> <totnmrssm>633</totnmrssm> <pertotnmrssm>2</pertotnmrssm> <ntssamountsm>24785000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중음악</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>2249</ntssnmrssm> <cancelnmrssm>735</cancelnmrssm> <totnmrssm>1514</totnmrssm> <pertotnmrssm>4</pertotnmrssm> <ntssamountsm>87016300</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중음악</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>4680</ntssnmrssm> <cancelnmrssm>2403</cancelnmrssm> <totnmrssm>2277</totnmrssm> <pertotnmrssm>7</pertotnmrssm> <ntssamountsm>203811000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중음악</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>28090</ntssnmrssm> <cancelnmrssm>11009</cancelnmrssm> <totnmrssm>17081</totnmrssm> <pertotnmrssm>49</pertotnmrssm> <ntssamountsm>2156117900</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>대중음악</catenm> <price>15만원이상</price> <ntssnmrssm>2172</ntssnmrssm> <cancelnmrssm>1166</cancelnmrssm> <totnmrssm>1006</totnmrssm> <pertotnmrssm>3</pertotnmrssm> <ntssamountsm>154645000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>복합</catenm> <price>0원</price> <ntssnmrssm>332</ntssnmrssm> <cancelnmrssm>175</cancelnmrssm> <totnmrssm>157</totnmrssm> <pertotnmrssm>22</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>복합</catenm> <price>3만원미만</price> <ntssnmrssm>634</ntssnmrssm> <cancelnmrssm>259</cancelnmrssm> <totnmrssm>375</totnmrssm> <pertotnmrssm>52</pertotnmrssm> <ntssamountsm>8026500</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>복합</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>268</ntssnmrssm> <cancelnmrssm>83</cancelnmrssm> <totnmrssm>185</totnmrssm> <pertotnmrssm>25</pertotnmrssm> <ntssamountsm>6900500</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>복합</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>11</ntssnmrssm> <cancelnmrssm>5</cancelnmrssm> <totnmrssm>6</totnmrssm> <pertotnmrssm>1</pertotnmrssm> <ntssamountsm>268000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>복합</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>7</ntssnmrssm> <cancelnmrssm>2</cancelnmrssm> <totnmrssm>5</totnmrssm> <pertotnmrssm>1</pertotnmrssm> <ntssamountsm>350000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>복합</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>복합</catenm> <price>15만원이상</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서커스/마술</catenm> <price>0원</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서커스/마술</catenm> <price>3만원미만</price> <ntssnmrssm>7868</ntssnmrssm> <cancelnmrssm>1506</cancelnmrssm> <totnmrssm>6362</totnmrssm> <pertotnmrssm>86</pertotnmrssm> <ntssamountsm>96848610</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서커스/마술</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>433</ntssnmrssm> <cancelnmrssm>62</cancelnmrssm> <totnmrssm>371</totnmrssm> <pertotnmrssm>5</pertotnmrssm> <ntssamountsm>14099100</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서커스/마술</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>197</ntssnmrssm> <cancelnmrssm>43</cancelnmrssm> <totnmrssm>154</totnmrssm> <pertotnmrssm>2</pertotnmrssm> <ntssamountsm>9231200</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서커스/마술</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>839</ntssnmrssm> <cancelnmrssm>326</cancelnmrssm> <totnmrssm>513</totnmrssm> <pertotnmrssm>7</pertotnmrssm> <ntssamountsm>42426600</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서커스/마술</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>4</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>4</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>480000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>서커스/마술</catenm> <price>15만원이상</price> <ntssnmrssm>7</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>7</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>1110000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>뮤지컬</catenm> <price>0원</price> <ntssnmrssm>42312</ntssnmrssm> <cancelnmrssm>41410</cancelnmrssm> <totnmrssm>902</totnmrssm> <pertotnmrssm>1</pertotnmrssm> <ntssamountsm>627224000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>뮤지컬</catenm> <price>3만원미만</price> <ntssnmrssm>26353</ntssnmrssm> <cancelnmrssm>5440</cancelnmrssm> <totnmrssm>20913</totnmrssm> <pertotnmrssm>18</pertotnmrssm> <ntssamountsm>461931766</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>뮤지컬</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>74273</ntssnmrssm> <cancelnmrssm>21999</cancelnmrssm> <totnmrssm>52274</totnmrssm> <pertotnmrssm>44</pertotnmrssm> <ntssamountsm>2064222020</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>뮤지컬</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>14520</ntssnmrssm> <cancelnmrssm>4242</cancelnmrssm> <totnmrssm>10278</totnmrssm> <pertotnmrssm>9</pertotnmrssm> <ntssamountsm>604524400</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>뮤지컬</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>12605</ntssnmrssm> <cancelnmrssm>5389</cancelnmrssm> <totnmrssm>7216</totnmrssm> <pertotnmrssm>6</pertotnmrssm> <ntssamountsm>588779700</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>뮤지컬</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>34018</ntssnmrssm> <cancelnmrssm>13510</cancelnmrssm> <totnmrssm>20508</totnmrssm> <pertotnmrssm>17</pertotnmrssm> <ntssamountsm>2340888000</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>뮤지컬</catenm> <price>15만원이상</price> <ntssnmrssm>17182</ntssnmrssm> <cancelnmrssm>10640</cancelnmrssm> <totnmrssm>6542</totnmrssm> <pertotnmrssm>6</pertotnmrssm> <ntssamountsm>1045271200</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>합계</catenm> <price>0원</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>합계</catenm> <price>3만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>합계</catenm> <price>3만원이상~5만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>합계</catenm> <price>5만원이상~7만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>합계</catenm> <price>7만원이상~10만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>합계</catenm> <price>10만원이상~15만원미만</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> <boxStatsof> <catenm>합계</catenm> <price>15만원이상</price> <ntssnmrssm>0</ntssnmrssm> <cancelnmrssm>0</cancelnmrssm> <totnmrssm>0</totnmrssm> <pertotnmrssm>0</pertotnmrssm> <ntssamountsm>0</ntssamountsm> </boxStatsof> </box-statsofs> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 boxStatsof catenm 장르 연극 price 가격대 0원 ntssnmrssm 예매수 16861 cancelnmrssm 취소수 7366 totnmrssm 총 티켓판매수 9495 pertotnmrssm 총 티켓판매수 장르별 비중 17 ntssamountsm 총 티켓판매액 75848000
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
기간별 통계
- 요청서비스
- 검색을 통한 일별 티켓판매수 및 티켓판매액 목록 서비스
※ 요일별은 7일, 일별은 31일까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfstsTotal
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 ststype o 7 날짜 코드 day(일별 : 최대 31일)
dayWeek(주별 : 최대 7일)stdate o 6 시작검색기간 20230101 eddate o 6 종료검색기간 20230101(최대 31일) - 요청/응답 메세지 예제
- 2023년도 6월에 대한 일별 티켓판매수 및 티켓판매액 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfstsTotal?service={ServiceKey}&stdate=20230601&eddate=20230601&ststype=day
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <prfsts> <prfst> <prfcnt>241</prfcnt> <ntssnmrs>115031</ntssnmrs> <cancelnmrs>42399</cancelnmrs> <amount>4438725897</amount> <nmrs>72632</nmrs> <prfdtcnt>458</prfdtcnt> <prfdt>20230108</prfdt> <prfprocnt>23</prfprocnt> </prfst> <prfst> <prfcnt>49</prfcnt> <ntssnmrs>5198</ntssnmrs> <cancelnmrs>1031</cancelnmrs> <amount>99597200</amount> <nmrs>4167</nmrs> <prfdtcnt>75</prfdtcnt> <prfdt>20230109</prfdt> <prfprocnt>6</prfprocnt> </prfst> <prfst> <prfcnt>117</prfcnt> <ntssnmrs>38026</ntssnmrs> <cancelnmrs>15542</cancelnmrs> <amount>1509967880</amount> <nmrs>22484</nmrs> <prfdtcnt>152</prfdtcnt> <prfdt>20230110</prfdt> <prfprocnt>9</prfprocnt> </prfst> <prfst> <prfcnt>138</prfcnt> <ntssnmrs>51306</ntssnmrs> <cancelnmrs>22017</cancelnmrs> <amount>1686308093</amount> <nmrs>29289</nmrs> <prfdtcnt>195</prfdtcnt> <prfdt>20230111</prfdt> <prfprocnt>15</prfprocnt> </prfst> <prfst> <prfcnt>168</prfcnt> <ntssnmrs>49197</ntssnmrs> <cancelnmrs>20119</cancelnmrs> <amount>1382589752</amount> <nmrs>29078</nmrs> <prfdtcnt>215</prfdtcnt> <prfdt>20230112</prfdt> <prfprocnt>29</prfprocnt> </prfst> </prfsts> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 prfcnt 공연건수 53 ntssnmrs 판매수 7323 cancelnmrs 취소수 1390 amount 티켓판매액 39526200 nmrs 총 티켓판매수 5256 prfdtcnt 상연횟수 61 prfdt 년월일 20160601 prfprocnt 개막편수 14
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
지역별 통계
- 요청서비스
- 검색을 통한 지역별 통계 목록 서비스
※ 최대 31일까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfstsArea
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 6 시작검색기간 20230601 eddate o 6 종료검색기간 20230607(최대 31일) - 요청/응답 메세지 예제
- 2023년6월1일부터 2023년6월7일까지의 지역별 통계 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfstsArea?service={ServiceKey}&stdate=20230601&eddate=20230607
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <prfsts> <prfst> <area>서울</area> <prfcnt>332</prfcnt> <totnmrs>292990</totnmrs> <amount>23191567661</amount> <nmrs>462133</nmrs> <prfdtcnt>1504</prfdtcnt> <seatcnt>567652</seatcnt> <fcltycnt>1305</fcltycnt> <nmrcancl>169143</nmrcancl> <prfplccnt>1651</prfplccnt> <prfprocnt>182</prfprocnt> </prfst> <prfst> <area>경상도</area> <prfcnt>87</prfcnt> <totnmrs>53322</totnmrs> <amount>2961831730</amount> <nmrs>72891</nmrs> <prfdtcnt>300</prfdtcnt> <seatcnt>802520</seatcnt> <fcltycnt>612</fcltycnt> <nmrcancl>19569</nmrcancl> <prfplccnt>823</prfplccnt> <prfprocnt>63</prfprocnt> </prfst> <prfst> <area>부산</area> <prfcnt>28</prfcnt> <totnmrs>18257</totnmrs> <amount>1595301160</amount> <nmrs>26965</nmrs> <prfdtcnt>104</prfdtcnt> <seatcnt>386996</seatcnt> <fcltycnt>192</fcltycnt> <nmrcancl>8708</nmrcancl> <prfplccnt>244</prfplccnt> <prfprocnt>18</prfprocnt> </prfst> <prfst> <area>경남</area> <prfcnt>15</prfcnt> <totnmrs>8537</totnmrs> <amount>687417750</amount> <nmrs>11668</nmrs> <prfdtcnt>41</prfdtcnt> <seatcnt>100575</seatcnt> <fcltycnt>121</fcltycnt> <nmrcancl>3131</nmrcancl> <prfplccnt>171</prfplccnt> <prfprocnt>12</prfprocnt> </prfst> <prfst> <area>대구</area> <prfcnt>32</prfcnt> <totnmrs>16939</totnmrs> <amount>375681290</amount> <nmrs>22130</nmrs> <prfdtcnt>114</prfdtcnt> <seatcnt>183218</seatcnt> <fcltycnt>138</fcltycnt> <nmrcancl>5191</nmrcancl> <prfplccnt>190</prfplccnt> <prfprocnt>25</prfprocnt> </prfst> <prfst> <area>울산</area> <prfcnt>5</prfcnt> <totnmrs>3698</totnmrs> <amount>165855530</amount> <nmrs>4998</nmrs> <prfdtcnt>26</prfdtcnt> <seatcnt>44036</seatcnt> <fcltycnt>43</fcltycnt> <nmrcancl>1300</nmrcancl> <prfplccnt>63</prfplccnt> <prfprocnt>2</prfprocnt> </prfst> <prfst> <area>경북</area> <prfcnt>7</prfcnt> <totnmrs>5891</totnmrs> <amount>137576000</amount> <nmrs>7130</nmrs> <prfdtcnt>15</prfdtcnt> <seatcnt>87695</seatcnt> <fcltycnt>118</fcltycnt> <nmrcancl>1239</nmrcancl> <prfplccnt>155</prfplccnt> <prfprocnt>6</prfprocnt> </prfst> <prfst> <area>충청도</area> <prfcnt>36</prfcnt> <totnmrs>25286</totnmrs> <amount>1712842300</amount> <nmrs>42071</nmrs> <prfdtcnt>98</prfdtcnt> <seatcnt>370430</seatcnt> <fcltycnt>269</fcltycnt> <nmrcancl>16785</nmrcancl> <prfplccnt>354</prfplccnt> <prfprocnt>28</prfprocnt> </prfst> <prfst> <area>대전</area> <prfcnt>19</prfcnt> <totnmrs>14897</totnmrs> <amount>1306284900</amount> <nmrs>28521</nmrs> <prfdtcnt>51</prfdtcnt> <seatcnt>249778</seatcnt> <fcltycnt>91</fcltycnt> <nmrcancl>13624</nmrcancl> <prfplccnt>112</prfplccnt> <prfprocnt>14</prfprocnt> </prfst> <prfst> <area>세종</area> <prfcnt>3</prfcnt> <totnmrs>4151</totnmrs> <amount>224099500</amount> <nmrs>5684</nmrs> <prfdtcnt>7</prfdtcnt> <seatcnt>8078</seatcnt> <fcltycnt>16</fcltycnt> <nmrcancl>1533</nmrcancl> <prfplccnt>31</prfplccnt> <prfprocnt>3</prfprocnt> </prfst> <prfst> <area>충북</area> <prfcnt>7</prfcnt> <totnmrs>2252</totnmrs> <amount>128678900</amount> <nmrs>2822</nmrs> <prfdtcnt>17</prfdtcnt> <seatcnt>36156</seatcnt> <fcltycnt>67</fcltycnt> <nmrcancl>570</nmrcancl> <prfplccnt>76</prfplccnt> <prfprocnt>4</prfprocnt> </prfst> <prfst> <area>충남</area> <prfcnt>7</prfcnt> <totnmrs>3986</totnmrs> <amount>53779000</amount> <nmrs>5044</nmrs> <prfdtcnt>23</prfdtcnt> <seatcnt>76418</seatcnt> <fcltycnt>95</fcltycnt> <nmrcancl>1058</nmrcancl> <prfplccnt>135</prfplccnt> <prfprocnt>7</prfprocnt> </prfst> <prfst> <area>경기/인천</area> <prfcnt>76</prfcnt> <totnmrs>35392</totnmrs> <amount>1516161150</amount> <nmrs>47824</nmrs> <prfdtcnt>241</prfdtcnt> <seatcnt>899622</seatcnt> <fcltycnt>523</fcltycnt> <nmrcancl>12432</nmrcancl> <prfplccnt>674</prfplccnt> <prfprocnt>55</prfprocnt> </prfst> <prfst> <area>경기</area> <prfcnt>56</prfcnt> <totnmrs>30323</totnmrs> <amount>1451233830</amount> <nmrs>41160</nmrs> <prfdtcnt>188</prfdtcnt> <seatcnt>722244</seatcnt> <fcltycnt>411</fcltycnt> <nmrcancl>10837</nmrcancl> <prfplccnt>528</prfplccnt> <prfprocnt>41</prfprocnt> </prfst> <prfst> <area>인천</area> <prfcnt>20</prfcnt> <totnmrs>5069</totnmrs> <amount>64927320</amount> <nmrs>6664</nmrs> <prfdtcnt>53</prfdtcnt> <seatcnt>177378</seatcnt> <fcltycnt>112</fcltycnt> <nmrcancl>1595</nmrcancl> <prfplccnt>146</prfplccnt> <prfprocnt>14</prfprocnt> </prfst> <prfst> <area>전라도</area> <prfcnt>38</prfcnt> <totnmrs>17467</totnmrs> <amount>774011600</amount> <nmrs>22827</nmrs> <prfdtcnt>119</prfdtcnt> <seatcnt>298781</seatcnt> <fcltycnt>262</fcltycnt> <nmrcancl>5360</nmrcancl> <prfplccnt>363</prfplccnt> <prfprocnt>26</prfprocnt> </prfst> <prfst> <area>전북</area> <prfcnt>14</prfcnt> <totnmrs>8152</totnmrs> <amount>579408920</amount> <nmrs>11178</nmrs> <prfdtcnt>30</prfdtcnt> <seatcnt>102612</seatcnt> <fcltycnt>106</fcltycnt> <nmrcancl>3026</nmrcancl> <prfplccnt>135</prfplccnt> <prfprocnt>8</prfprocnt> </prfst> <prfst> <area>전남</area> <prfcnt>14</prfcnt> <totnmrs>5931</totnmrs> <amount>116810100</amount> <nmrs>7403</nmrs> <prfdtcnt>47</prfdtcnt> <seatcnt>109246</seatcnt> <fcltycnt>84</fcltycnt> <nmrcancl>1472</nmrcancl> <prfplccnt>118</prfplccnt> <prfprocnt>12</prfprocnt> </prfst> <prfst> <area>광주</area> <prfcnt>10</prfcnt> <totnmrs>3384</totnmrs> <amount>77792580</amount> <nmrs>4246</nmrs> <prfdtcnt>42</prfdtcnt> <seatcnt>86923</seatcnt> <fcltycnt>72</fcltycnt> <nmrcancl>862</nmrcancl> <prfplccnt>110</prfplccnt> <prfprocnt>6</prfprocnt> </prfst> <prfst> <area>강원도</area> <prfcnt>6</prfcnt> <totnmrs>4988</totnmrs> <amount>169543600</amount> <nmrs>6231</nmrs> <prfdtcnt>16</prfdtcnt> <seatcnt>356780</seatcnt> <fcltycnt>150</fcltycnt> <nmrcancl>1243</nmrcancl> <prfplccnt>212</prfplccnt> <prfprocnt>4</prfprocnt> </prfst> <prfst> <area>제주도</area> <prfcnt>9</prfcnt> <totnmrs>2062</totnmrs> <amount>54310900</amount> <nmrs>2582</nmrs> <prfdtcnt>47</prfdtcnt> <seatcnt>84675</seatcnt> <fcltycnt>68</fcltycnt> <nmrcancl>520</nmrcancl> <prfplccnt>84</prfplccnt> <prfprocnt>6</prfprocnt> </prfst> <prfst> <area>합계</area> <prfcnt>584</prfcnt> <totnmrs>431507</totnmrs> <amount>30380268941</amount> <nmrs>656559</nmrs> <prfdtcnt>2325</prfdtcnt> <seatcnt>3380460</seatcnt> <fcltycnt>3189</fcltycnt> <nmrcancl>225052</nmrcancl> <prfplccnt>4161</prfplccnt> <prfprocnt>364</prfprocnt> </prfst> </prfsts> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 area 지역 서울 prfcnt 공연건수 253 totnmrs 총 티켓판매수 15062 amount 총 티켓판매액 3278335844 nmrs 판매수 17058 prfdtcnt 상연횟수 1956 seatcnt 좌석수 389318 fcltycnt 공연시설 855 nmrcancl 취소수 1996 prfplccnt 공연장 1066 prfprocnt 개막편수 181
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
공연 시설별 통계
- 요청서비스
- 검색을 통한 공연 시설별 통계 목록 서비스
※ 최대 31일 및 100건까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfstsPrfByFct
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 cpage o 3 현재페이지 1 rows o 3 페이지당 목록 수 10 (최대 100건) stdate o 6 시작검색기간 20230601 eddate o 6 종료검색기간 20230607(최대 31일) sharea X 2 지역(시도)코드 11 shprfnmfct X 100 공연시설명 예술의전당(URLEncoding) - 요청/응답 메세지 예제
- 2023년6월1일부터 2023년6월7일까지의 지역(시도)코드 11에 대한 공연시설명이 예술의전당인 공연시설의 통계 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfstsPrfByFct?service={ServiceKey}&cpage=1&rows=10&stdate=20230601&eddate=20230607&sharea=11&shprfnmfct=예술의전당
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <prfsts> <prfst> <prfnmfct>예술의전당 [서울]</prfnmfct> <prfcnt>1</prfcnt> <totnmrs>2028</totnmrs> <prfnmplc>CJ 토월극장</prfnmplc> <prfdtcnt>5</prfdtcnt> <seatcnt>1004</seatcnt> <prfprocnt>0</prfprocnt> </prfst> <prfst> <prfnmfct>예술의전당 [서울]</prfnmfct> <prfcnt>8</prfcnt> <totnmrs>2051</totnmrs> <prfnmplc>리사이틀홀</prfnmplc> <prfdtcnt>8</prfdtcnt> <seatcnt>354</seatcnt> <prfprocnt>8</prfprocnt> </prfst> <prfst> <prfnmfct>예술의전당 [서울]</prfnmfct> <prfcnt>4</prfcnt> <totnmrs>7911</totnmrs> <prfnmplc>콘서트홀</prfnmplc> <prfdtcnt>4</prfdtcnt> <seatcnt>2505</seatcnt> <prfprocnt>4</prfprocnt> </prfst> <prfst> <prfnmfct>예술의전당 [서울]</prfnmfct> <prfcnt>1</prfcnt> <totnmrs>843</totnmrs> <prfnmplc>자유소극장</prfnmplc> <prfdtcnt>4</prfdtcnt> <seatcnt>241</seatcnt> <prfprocnt>1</prfprocnt> </prfst> <prfst> <prfnmfct>예술의전당 [서울]</prfnmfct> <prfcnt>7</prfcnt> <totnmrs>3507</totnmrs> <prfnmplc>IBK챔버홀</prfnmplc> <prfdtcnt>7</prfdtcnt> <seatcnt>600</seatcnt> <prfprocnt>7</prfprocnt> </prfst> </prfsts> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 prfnmfct 공연시설명 예술의전당 [서울] prfcnt 공연건수 1 totnmrs 총 티켓판매수 2028 prfnmplc 공연장명 CJ토월극장 prfdtcnt 상연횟수 5 seatcnt 좌석수 1004 prfprocnt 개막편수 0
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
가격대별 통계
- 요청서비스
- 검색을 통한 가격대별 통계 목록 서비스
※ 최대 31일까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfstsPrice
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 6 시작검색기간 20230601 eddate o 6 종료검색기간 20230607 (최대 31일) shcate X 4 장르코드 AAAA - 요청/응답 메세지 예제
- 2023년6월1일부터 2023년6월7일까지의 장르코드 연극(코드:AAAA)에 대한 가격대별 통계 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfstsPrice?service={ServiceKey}&stdate=20230601&eddate=20230607&shcate=AAAA
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <prfsts> <prfst> <totnmrs>31507</totnmrs> <cate>연극</cate> <amount>0</amount> <nmrs>63076</nmrs> <nmrcancl>31569</nmrcancl> <amountsmratio>15.3</amountsmratio> <price>0원</price> </prfst> <prfst> <totnmrs>123287</totnmrs> <cate>연극</cate> <amount>1927102728</amount> <nmrs>146388</nmrs> <nmrcancl>23101</nmrcancl> <amountsmratio>60.0</amountsmratio> <price>3만원미만</price> </prfst> <prfst> <totnmrs>25620</totnmrs> <cate>연극</cate> <amount>970271150</amount> <nmrs>37412</nmrs> <nmrcancl>11792</nmrcancl> <amountsmratio>12.5</amountsmratio> <price>3만원이상~5만원미만</price> </prfst> <prfst> <totnmrs>15160</totnmrs> <cate>연극</cate> <amount>915577100</amount> <nmrs>27262</nmrs> <nmrcancl>12102</nmrcancl> <amountsmratio>7.4</amountsmratio> <price>5만원이상~7만원미만</price> </prfst> <prfst> <totnmrs>9998</totnmrs> <cate>연극</cate> <amount>810943600</amount> <nmrs>16558</nmrs> <nmrcancl>6560</nmrcancl> <amountsmratio>4.9</amountsmratio> <price>7만원이상~10만원미만</price> </prfst> <prfst> <totnmrs>0</totnmrs> <cate>연극</cate> <amount>0</amount> <nmrs>0</nmrs> <nmrcancl>0</nmrcancl> <amountsmratio>0.0</amountsmratio> <price>10만원이상~15만원미만</price> </prfst> <prfst> <totnmrs>5</totnmrs> <cate>연극</cate> <amount>29722500</amount> <nmrs>5</nmrs> <nmrcancl>0</nmrcancl> <amountsmratio>0.0</amountsmratio> <price>15만원이상</price> </prfst> </prfsts> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 totnmrs 총 티켓판매수 31507 cate 장르 연극 amount 예매액 0 nmrs 예매수 63076 nmrcancl 취소수 31569 amountsmratio 예매액 비중 15.3 price 가격대 0원
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
장르별 통계
- 요청서비스
- 검색을 통한 장르별 통계 목록 서비스※ 최대 31일까지만 조회 제공
- 요청 URL
- http://kopis.or.kr/openApi/restful/prfstsCate
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 시작검색기간 20230601 eddate o 8 종료검색기간 20230607 (최대 31일) - 요청/응답 메세지 예제
- 2023년6월1일부터 2023년6월7일까지의 장르별 티켓판매수 및 티켓판매액 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfstsCate?service={ServiceKey}&stdate=20230601&eddate=20230607
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <prfsts> <prfst> <cate>연극</cate> <amount>1496352101</amount> <nmrs>55345</nmrs> <prfdtcnt>1003</prfdtcnt> <nmrsshr>12.8</nmrsshr> <prfprocnt>41</prfprocnt> <amountshr>4.9</amountshr> </prfst> <prfst> <cate>뮤지컬</cate> <amount>8540290410</amount> <nmrs>154449</nmrs> <prfdtcnt>848</prfdtcnt> <nmrsshr>35.8</nmrsshr> <prfprocnt>87</prfprocnt> <amountshr>28.1</amountshr> </prfst> <prfst> <cate>복합</cate> <amount>21862000</amount> <nmrs>5471</nmrs> <prfdtcnt>26</prfdtcnt> <nmrsshr>1.3</nmrsshr> <prfprocnt>10</prfprocnt> <amountshr>0.1</amountshr> </prfst> </prfsts> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 cate 장르 연극 amount 티켓판매액 1496352101 nmrs 티켓판매수 55345 prfdtcnt 상연횟수 1003 nmrsshr 관객점유율 12.8 prfprocnt 개막편수 41 amountshr 티켓판매액 점유율 4.9
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
국내/내한별 통계
- 요청서비스
- 검색을 통한 국내/내한별 통계 목록 서비스
※ 최대 31일까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfstsCreate
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 stdate o 8 시작검색기간 20230601 eddate o 8 종료검색기간 20230607(최대 31일) - 요청/응답 메세지 예제
- 2023년6월1일부터 2023년6월7일까지의 국내/내한별 티켓판매수 및 티켓판매액 목록 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfstsCreate?service={ServiceKey}&stdate=20230601&eddate=20230607
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <prfsts> <prfst> <nmrs>1047</nmrs> <amount>10141600</amount> <creategbn>국내</creategbn> <amountshr>97.8</amountshr> <prfprocnt>6</prfprocnt> <cate>연극</cate> <prfdtcnt>54</prfdtcnt> <nmrsshr>98.7</nmrsshr> </prfst> <prfst> <nmrs>14</nmrs> <amount>223000</amount> <creategbn>해외라이선스</creategbn> <amountshr>2.2</amountshr> <prfprocnt>0</prfprocnt> <cate>연극</cate> <prfdtcnt>6</prfdtcnt> <nmrsshr>1.3</nmrsshr> </prfst> <prfst> <nmrs>4388</nmrs> <amount>42201600</amount> <creategbn>국내</creategbn> <amountshr>100.0</amountshr> <prfprocnt>7</prfprocnt> <cate>뮤지컬</cate> <prfdtcnt>33</prfdtcnt> <nmrsshr>100.0</nmrsshr> </prfst> </prfsts> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 nmrs 티켓판매수 1047 amount 티켓판매액 10141600 creategbn 창작구분 국내 amountshr 티켓판매액 점유율 97.8 prfprocnt 개막편수 6 cate 장르 연극 prfdtcnt 상연횟수 54 nmrsshr 관객점유율 98.7
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
공연별 통계
- 요청서비스
- 검색을 통한 공연별 통계 목록 서비스
※ 최대 31일 및 100건까지만 조회 제공 - 요청 URL
- http://kopis.or.kr/openApi/restful/prfstsPrfBy
- 요청 변수
-
요청 변수 변수명 필수 크기 설명 샘플데이터 service o 60 발급받은 인증키 cpage o 3 현재페이지 1 rows o 3 페이지당 목록 수 10 (최대 100건) stdate o 8 시작검색기간 20230601 eddate o 8 종료검색기간 20230607(최대 31일) shcate x 4 장르코드 AAAA shprfnm x 100 공연명 살고지고(URLEncoding) - 요청/응답 메세지 예제
- 2023년6월1일부터 2023년6월7일까지의 '아들'이라는 공연명의 장르 코드 AAAA인 공연의 통계 요청
- -요청 URL
- http://www.kopis.or.kr/openApi/restful/prfstsPrfBy?service={ServiceKey}&stdate=20230601&eddate=20230607&cpage=1&rows=10&shcate=AAAA&shprfnm=살고지고
- -응답 메세지
<?xml version="1.0" encoding="UTF-8"?> <prfsts> <prfst> <cate>연극</cate> <prfnm>살고지고</prfnm> <mt20id>PF219233</mt20id> <prfdtcnt>4</prfdtcnt> <prfpdfrom>2023.06.02</prfpdfrom> <fcltynm>지구인아트홀 (구. 해오름 예술극장)</fcltynm> <entrpsnm> </entrpsnm> <prfpdto>2023.09.03</prfpdto> </prfst> </prfsts> - 출력결과 필드
-
출력결과 필드 필드명 설명 샘플데이터 cate 장르 연극 prfnm 공연명 살고지고 mt20id 공연ID PF131558 prfdtcnt 상연횟수 4 prfpdfrom 공연시작일 2023.06.02 fcltynm 공연시설명 지구인아트홀 (구. 해오름 예술극장) entrpsnm 기획/제작사 prfpdto 공연종료일 2023.09.03
- 결과코드
-
출력결과 필드 결과코드 설명 00 NORMAL SERVICE 01 INVALID REQUEST PARAMETER ERROR 02 SERVICE KEY IS NOT REGISTERED ERROR 03 DB_ERROR 04 NODATA ERROR 05 최대 31일까지 조회가능합니다. 06 최대 조회수는 100건까지 가능합니다.
(03082) 서울시 종로구 대학로 57 (연건동) 홍익대학교 대학로 캠퍼스 교육동 12층 예술경영지원센터
TEL. 02-708-2214(통계 분석·연구), 02-2098-2945(연계기관·API·My통계) FAX. 02-2098-2904 E-mail. kopis@gokams.or.kr
COPYRIGHT © KOREA PERFORMING ARTS BOX OFFICE INFORMATION SYSTEM
