KMDb - 한국영화데이터베이스

영화상세정보
담당부서	정보자원개발팀
담당자	김계영
최종수정일	2018년 03월 20일
이용허락조건

인증키를 신청하기 위해서는 한국영상자료원 회원 계정으로 로그인 하셔야 합니다.

인증키 신청

영화상세정보

영화상세정보를 영화명, 감독, 키워드 등의 요청값을 통해 조회합니다.
호출방식은 REST, 응답형식은 XML과 JSON을 지원합니다.
기본 요청 URL : http://api.koreafilm.or.kr/openapi-data2/wisenut/search_api/search_xml2(또는 search_json2).jsp?collection=kmdb_new2
예시) http://api.koreafilm.or.kr/openapi-data2/wisenut/search_api/search_xml2.jsp?collection=kmdb_new2&detail=N&director=%EB%B0%95%EC%B0%AC%EC%9A%B1&ServiceKey=인증키값

요청인자

출력값

샘플코드

에러 및 정보메시지

요청인자

파일데이터 테이블
변수명	타입	변수설명	값 설명	샘플데이터
ServiceKey	STRING (필수)	API 서비스 인증키	API 서비스 인증키 문자열
listCount	Integer (3이상)	통합검색 출력 결과수	통합검색 출력 결과수(최대값=500)	3
startCount	Integer	검색 결과 시작 번호	0번부터 시작하는 검색 결과의 순차번호로 지정한 번호의 결과에서 한페이지에서 보여줄 개수(번들 카운트)만큼 결과 전송한다.	0 이상의 10단위 숫자
collection	STRING	검색 대상 컬렉션 지정	고정값	kmdb_new
query	STRING	검색 질의어	통합검색 질의어	문자열
detail	STRING	상세정보 출력여부	상세정보 출력 여부	Y or N
sort	STRING	결과 정렬	기본 정렬 값은 정확도이며 형식은 필드명,1 또는 필드명,0 이다.	RANK 정확도순 정렬 title 영화명 정렬 director 감독명 정렬 company 제작사명 정렬 prodYear 제작년도 정렬
createDts	STRING	기간 검색	제작년도 시작	YYYY 형식 문자열
createDte	STRING	기간 검색	제작년도 종료	YYYY 형식 문자열
releaseDts	STRING	기간 검색	개봉일 시작	YYYYMMDD 형식 문자열
releaseDte	STRING	기간 검색	개봉일 종료	YYYYMMDD 형식 문자열
nation	STRING	상세검색	국가명 ex)대한민국, 일본, 오스트리아 등	문자열
company	STRING	상세검색	제작사명	문자열
genre	STRING	상세검색	장르명	문자열
ratedYn	STRING	상세검색	심의여부(y/n)	문자열
use	STRING	상세검색	용도구분	문자열
movieId	STRING	상세검색	movie_Id	문자열
movieSeq	STRING	상세검색	movie_seq	문자열
type	STRING	상세검색	유형명 (극영화/애니메이션/다큐멘터리/광고홍보물/교육물/뮤직비디오/실황공연물/정보물/기록물/실험영화/온라인영화/미디어아트/기타)	문자열
title	STRING	상세검색	영화명	문자열
director	STRING	상세검색	감독명	문자열
actor	STRING	상세검색	배우명	문자열
staff	STRING	상세검색	스탭명	문자열
keyword	STRING	상세검색	키워드	문자열
plot	STRING	상세검색	줄거리	문자열

출력값

출력값 테이블
번호	출력명	출력설명	샘플데이터
1	Result	Collection, PageNo, NumOfRow, TotalCount	Collection 명, 검색결과시작, 화면에 노출될 결과개수, 총결과수
2	Row Value	검색결과 리스트 내 일련번호
3	docid	pk
4	movieId	등록ID	K
5	movieSeq	등록SEQ	04629
6	title	영화명	서편제
7	titleEng	영문제명
8	titleOrg	원제명
9	titleEtc	기타제명(제명 검색을 위해 관리되는 제명 모음)
10	directorNm	감독명	김지훈
11	directorEnNm	감독명(영문)	Kim Ji Hoon
12	directorId	감독등록번호	00044214
13	actorNm	배우명	하지원
14	actorEnNm	배우명(영문)	Ha Ji-won
15	actorId	배우등록번호	00004417
16	nation	제작국가	대한민국
17	company	제작사	㈜JK필름,CJ E&M Pictures
18	prodYear	제작년도	2011
19	plot	줄거리	제주도 남단, 7광구의.....
20	runtime	대표상영시간	112
21	rating	대표관람등급	15세관람가
22	genre	kmdbUrl	액션,SF
23	kmdbUrl	링크URL	https://www.kmdb.or.kr/db/kor/detail/movie/K/18606
24	type	유형구분	극영화
25	use	용도구분	극장용
26	episodes	영상 내 에피소드
27	ratedYn	심의여부	Y
28	repRatDate	대표심의일	2011-07-13
29	repRlsDate	대표개봉일	2011-08-04
30	ratingMain	대표심의정보 여부	Y
31	ratingDate	심의일	2011-07-13
32	ratingNo	심의번호	2011-F363
33	ratingGrade	관람기준	15세관람가
34	releaseDate	개봉일자	2011-08-04
35	runtime	상영시간	112
36	keywords	키워드	괴물,괴생물체,석유,심해,해저
37	posterUrl	포스터이미지URL	http://file.koreafilm.or.kr/thm/02/00/01/46/tn_DPK004440.JPG
38	stillUrl	스틸이미지URL	http://file.koreafilm.or.kr/thm/01/copy/00/37/32/tn_DSKT155961.jpg
39	StaffNm	스텝이름	하지원
40	staffRoleGroup	스텝크레딧명	출연
41	StaffRole	스텝배역	차해준
42	StaffEtc	스텝기타
43	StaffId	스텝등록번호	00004417
44	vodClass	VOD 구분	티저 예고편
45	vodUrl	VOD URL	http://www.kmdb.or.kr/vod/vod_basic.asp?nation=K&p_dataid=12599&pgGubun=04
46	openThtr	개봉극장
47	screenArea	관람지역
48	screenCnt	스크린수
49	salesAcc	누적매출액
50	audiAcc	누적관람인원
51	statSouce	출처
52	statDate	기준일
53	themeSong	주제곡
54	soundtrack	삽입곡	"Blow out" 스윗리벤지
55	fLocation	촬영장소
56	Awards1	영화제수상내역
57	Awards2	수상내역 기타
58	regDate	등록일	2010-12-20
59	modDate	최종수정일	2016-02-16
60	CodeNm	외부코드명	FIMS
61	CodeNo	외부코드	20182530
62	CommCodes	대표외부코드	20182530

샘플코드

샘플코드 테이블
Java	/* Java 샘플 코드 / import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import java.net.URLEncoder; import java.io.BufferedReader; import java.io.IOException; public class ApiExplorer { public static void main(String[] args) throws IOException { StringBuilder urlBuilder = new StringBuilder("http://api.koreafilm.or.kr/openapi-data2/wisenut/search_api/search_json2.jsp?collection=kmdb_new2&nation=대한민국"); /URL/ urlBuilder.append("?" + URLEncoder.encode("ServiceKey","UTF-8") "=서비스키"); /Service Key/ urlBuilder.append("&" + URLEncoder.encode("val001","UTF-8") + "=" + URLEncoder.encode("2018", "UTF-8")); /상영년도/ urlBuilder.append("&" + URLEncoder.encode("val002","UTF-8") + "=" + URLEncoder.encode("01", "UTF-8")); /상영 월*/ URL url = new URL(urlBuilder.toString()); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setRequestMethod("GET"); conn.setRequestProperty("Content-type", "application/json"); System.out.println("Response code: " + conn.getResponseCode()); BufferedReader rd; if(conn.getResponseCode() >= 200 && conn.getResponseCode() <= 300) { rd = new BufferedReader(new InputStreamReader(conn.getInputStream())); } else { rd = new BufferedReader(new InputStreamReader(conn.getErrorStream())); } StringBuilder sb = new StringBuilder(); String line; while ((line = rd.readLine()) != null) { sb.append(line); } rd.close(); conn.disconnect(); System.out.println(sb.toString()); } }
Javascript	/* Javascript 샘플 코드 / var xhr = new XMLHttpRequest(); var url = 'http://api.koreafilm.or.kr/openapi-data2/wisenut/search_api/search_json2.jsp?collection=kmdb_new2&nation=대한민국'); /URL/ var queryParams = '?' + encodeURIComponent('ServiceKey=서비스키'; /Service Key/ queryParams += '&' + encodeURIComponent('val001') + '=' + encodeURIComponent('2018')); /상영년도/ queryParams += '&' + encodeURIComponent('val002') + '=' + encodeURIComponent('01')); /상영월*/ xhr.open('GET', url + queryParams); xhr.onreadystatechange = function () { if (this.readyState == 4) { alert('Status: '+this.status+'Headers: '+JSON.stringify(this.getAllResponseHeaders())+'Body: '+this.responseText); } }; xhr.send('');
PHP	/* PHP 샘플 코드 / $ch = curl_init(); $url = 'http://api.koreafilm.or.kr/openapi-data2/wisenut/search_api/search_json2.jsp?collection=kmdb_new2&nation=대한민국'; /URL/ $queryParams = '?' . urlencode('ServiceKey') . '=서비스키'; /Service Key/ $queryParams .= '&' . urlencode('val001') . '=' . urlencode('2018'); /상영년도/ $queryParams .= '&' . urlencode('val002') . '=' . urlencode('01'); /상영월*/ curl_setopt($ch, CURLOPT_URL, $url . $queryParams); curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); curl_setopt($ch, CURLOPT_HEADER, FALSE); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET'); $response = curl_exec($ch); curl_close($ch); var_dump($response);

로고

영화상세정보

영화상세정보

요청인자

출력값

샘플코드

에러 및 정보메시지

알림

알림

초기화면 설정