본문 바로가기
Back-end/JAVA

[JAVA] 영화 박스오피스 오픈 API (1) - 준비

by 허도치 2020. 11. 16.
서론

  이번 포스트에서는 영화진흥위원회(KOFIC)에서 제공하는 OPEN API를 이용하여 영화 박스오피스 데이터를 수집하는 인터페이스를 구축해볼 계획이다. 아주 간단하지만 재밌는 예제이고 유용하게 사용할 수 있다고 생각한다.

 

 

 

영화진흥위원회 오픈API
1. 홈페이지 소개

  - 영화진흥위원회 영화관입장권통합전산망에서 제공하는 오픈API 서비스.

  - 아래와 같은 데이터를 제공함

  • 박스오피스 - 일일박스오피스, 주간/주말 박스오피스
  • 영화정보 - 영화목록, 영화상세정보
  • 영화사정보 - 영화사목록, 영화사상세정보
  • 영화인정보 - 영화인목록, 영화인상세정보

  - 회원제 서비스이기 때문에 회원가입 후 이용할 수 있음.

 

  - www.kobis.or.kr/kobisopenapi/homepg/main/main.do

 

영화진흥위원회 오픈API

 

www.kobis.or.kr

 

2. 회원가입

[ 이용약관 확인 후 '회원 가입 진행' ]

 

[ 개인정보 입력 후 '가입' ]

 

[ 가입확인하기! ]

 

[ '회원 인증 처리하러 가기' 버튼을 클릭하면 완료! ]

 

3. 키발급 하기

[ 키 발급/관리 탭으로 이동 ]

 

[ '키 발급받기' 버튼 클릭 ]

 

[ '사용 목적', '관리명' 입력 후 '키 발급' 클릭 ]

 

[ 키 발급 완료! ]

 

4. 박스오피스 API 정보

  - 요청URL

     http://www.kobis.or.kr/kobisopenapi/webservice/rest/boxoffice/searchDailyBoxOfficeList..json

 

  - 요청(Request) 인터페이스

변수 설명
key 문자열(필수) 발급받은키 값을 입력합니다.
targetDt 문자열(필수) 조회하고자 하는 날짜를 yyyymmdd 형식으로 입력합니다.
itemPerPage 문자열 결과 ROW 의 개수를 지정합니다.(default : “10”, 최대 : “10“)
multiMovieYn 문자열 다양성 영화/상업영화를 구분지어 조회할 수 있습니다.
“Y” : 다양성 영화 “N” : 상업영화 (default : 전체)
repNationCd 문자열 한국/외국 영화별로 조회할 수 있습니다.
“K: : 한국영화 “F” : 외국영화 (default : 전체)
wideAreaCd 문자열 상영지역별로 조회할 수 있으며, 지역코드는 공통코드 조회 서비스에서 “0105000000” 로서 조회된 지역코드입니다. (default : 전체)

 

  - 응답(Response) 구조

응답 필드 설명
boxofficeType 문자열 박스오피스 종류를 출력합니다.
showRange 문자열 박스오피스 조회 일자를 출력합니다.
rnum 문자열 순번을 출력합니다.
rank 문자열 해당일자의 박스오피스 순위를 출력합니다.
rankInten 문자열 전일대비 순위의 증감분을 출력합니다.
rankOldAndNew 문자열 랭킹에 신규진입여부를 출력합니다.
“OLD” : 기존 , “NEW” : 신규
movieCd 문자열 영화의 대표코드를 출력합니다.
movieNm 문자열 영화명(국문)을 출력합니다.
openDt 문자열 영화의 개봉일을 출력합니다.
salesAmt 문자열 해당일의 매출액을 출력합니다.
salesShare 문자열 해당일자 상영작의 매출총액 대비 해당 영화의 매출비율을 출력합니다.
salesInten 문자열 전일 대비 매출액 증감분을 출력합니다.
salesChange 문자열 전일 대비 매출액 증감 비율을 출력합니다.
salesAcc 문자열 누적매출액을 출력합니다.
audiCnt 문자열 해당일의 관객수를 출력합니다.
audiInten 문자열 전일 대비 관객수 증감분을 출력합니다.
audiChange 문자열 전일 대비 관객수 증감 비율을 출력합니다.
audiAcc 문자열 누적관객수를 출력합니다.
scrnCnt 문자열 해당일자에 상영한 스크린수를 출력합니다.
showCnt 문자열 해당일자에 상영된 횟수를 출력합니다.

 

 

 

5. 예시URL

     http://www.kobis.or.kr/kobisopenapi/webservice/rest/boxoffice/searchDailyBoxOfficeList.json?key=430156241533f1d058c603178cc3ca0e&targetDt=20120101

[ 예시 데이터 ]

  - URL의 파라미터를 확인해보면, [ key=430156241533f1d058c603178cc3ca0e&targetDt=20120101 ] 요청 인터페이스 목록에 있는 keytargetDt 가 사용된 것을 확인할 수 있음.

  - 추가로 itemPerPagemultiMovieYnrepNationCd, wideAreaCd 를 적용해보면 다양한 결과를 확인 할 수 있음.

 

 

 

 

 

마치며

  지금까지 영화진흥위원회 오픈API를 사용하기위해 회원가입을 하고 API 연계를 위한 인증키를 발급 받았다. 그리고, 박스오피스 정보를 요청할 때 필요한 정보와 응답받을 수 있는 데이터들도 확인해보았다. 다음 포스트에서는 JAVA 소스를 통해 데이터를 수집해보도록 하겠다.

 

댓글