오픈API 사용가이드 - 문화포털API

홈 메인

문화포털API

문화포털에서 서비스 하고 있는 자료를 개인 또는 기관에서 OPEN API를 통해 자유롭게 이용할 수 있도록 제공합니다

문화포털 open api 서비스 안내

OPEN API 서비스를
아래와 같이 변경하였습니다.

신규 서비스 이용 부탁드립니다.

2025. 4. 7(월)부터 (구)서비스는 중단 될 예정입니다.

서비스 명칭 변경 및 현행화

(구) 서비스

한국문화정보원_한국의문양조회서비스
한국문화정보원_티켓할인조회서비스
한국문화정보원_문화예술공간조회서비스

신규서비스

한국문화정보원_전통문양조회서비스
한국문화정보원_문화릴레이티켓할인조회서비스
한국문화정보원_문화시설조회서비스

서비스 통합 및 현행화

(구) 서비스

한국문화정보원_공연전시정보조회서비스
한국문화정보원_문화정보조회서비스

신규서비스

한국문화정보원_한눈에보는문화정보조회서비스

문화포털
OPEN API 사용안내

기본적으로 제공 API 서비스를 사용하시기 위하여 ‘서비스 인증키’ 를 개별적으로 발급받으셔야 합니다. 발급기관은 아래와 같습니다.
공공데이터포털 http://www.data.go.kr
오픈API
<URL> 조합 예시

요청URL + 검색조건 값(파라미터) + Service Key (Service Key에 대한 부분은 UTF-8로 URL 인코딩하여 보내야 함)

http://www.culture.go.kr/openapi/rest/publicperformancedisplays/period?from=20101118&to=20101217&cPage=1&rows=10&place=&gpsxfrom=&gpsyfrom=&gpsxto=&gpsyto=&keyword=&sortStdr=1&serviceKey={서비스 키}

※ 자세한 사항은 각 조회서비스별 개발가이드를 참고하시기 바랍니다.

공연전시 정보
조회서비스

공연전시정보조회서비스는 공연전시정보에 대한 검색 결과를 외부에 REST 방식으로 전달하는 API서비스이다.

오퍼레이션 목록

오퍼레이션 목록
오퍼레이션	서비스 내용	전송방식	요청URL
기간별공연 전시목록조회	기간별공연/전시 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/publicperformancedisplays/period
지역별공연 전시목록조회	지역별공연/전시 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/publicperformancedisplays/area
분야별공연 전시목록조회	분야별공연/전시 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/publicperformancedisplays/realm
공연/전시 상세정보조회	공연/전시 상세정보를 조회한다.	REST	http://www.culture.go.kr/openapi/rest/publicperformancedisplays/d/?seq={공연/전시번호

개발가이드 다운로드

공연전시정보조회서비스 개발가이드 https://www.culture.go.kr/guide/docs/ppds_guide.zip

에러메시지

00 : NORMAL SERVICE
01 : APPLICATION ERROR
02 : DB_ERROR
03 : NODATA ERROR
04 : HTTP ERROR
05 : SERVICETIMEOUT ERROR
10 : INVALID REQUEST PARAMETER ERROR
11 : MANDATORY REQUEST PARAMETERS ERROR
12 : NO OPENAPI SERVICE ERROR
20 : SERVICE ACCESS DENIED ERROR
21 : TEMPORARILY DISABLE THE SERVICEKEY ERROR
22 : LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS ERROR
30 : SERVICE KEY IS NOT REGISTERED ERROR
31 : DEADLINE HAS EXPIRED ERROR
32 : UNREGISTERED IP ERROR
33 : UNSIGNED CALL ERROR
99 : UNKNOWN ERROR

문화예술공간
조회서비스

문화예술공간조회서비스는 문화예술공간에 대한 검색 결과를 외부에 REST방식으로 전달하는 API서비스이다.

오퍼레이션 목록

오퍼레이션 목록
오퍼레이션	서비스 내용	전송방식	요청URL
공연장정보 목록조회	공연장정보 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureartspaces/performingplace
미술관정보 목록조회	박물관정보 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureartspaces/museum
박물관정보 목록조회	분야별공연/전시 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/publicperformancedisplays/realm
문화/복지 시군구회관 정보목록조회	문화/복지 시군구회관정보 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureartspaces/hall
도서관정보 목록조회	도서관정보 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureartspaces/library
문화예술 공간정보 상세정보조회	문화예술 공간정보 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureartspaces/d/?seq={공간번호}

개발가이드 다운로드

문화예술공간조회서비스 개발가이드 https://www.culture.go.kr/guide/docs/cass_guide.zip

에러메시지

00 : NORMAL SERVICE
01 : APPLICATION ERROR
02 : DB_ERROR
03 : NODATA ERROR
04 : HTTP ERROR
05 : SERVICETIMEOUT ERROR
10 : INVALID REQUEST PARAMETER ERROR
11 : MANDATORY REQUEST PARAMETERS ERROR
12 : NO OPENAPI SERVICE ERROR
20 : SERVICE ACCESS DENIED ERROR
21 : TEMPORARILY DISABLE THE SERVICEKEY ERROR
22 : LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS ERROR
30 : SERVICE KEY IS NOT REGISTERED ERROR
31 : DEADLINE HAS EXPIRED ERROR
32 : UNREGISTERED IP ERROR
33 : UNSIGNED CALL ERROR
99 : UNKNOWN ERROR

문화정보 조회서비스

문화정보조회서비스는 문화정보에 대한 검색 결과를 외부에 REST방식으로 전달하는 API서비스이다.

오퍼레이션 목록

오퍼레이션 목록
오퍼레이션	서비스 내용	전송방식	요청URL
문화 웹진 목록조회	문화 웹진 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/newsletter
문화UCC 목록조회	문화UCC 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/uccs
문화UCC 상세조회	문화UCC 상세정보를 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/uccs/d/?idx={ucc번호}
문화UCC(모바일) 목록조회	문화UCC(모바일) 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/uccm
문화공지사항 목록조회	문화공지사항 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/policy
문화채용 정보목록조회	문화채용정보 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/employments
문화채용정보 상세정보조회	문화채용정보 상세정보를 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/employments/d/?seq={채용번호})
문화캘린더정보 목록조회	문화캘린더정보 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/livelihood
한눈에보는문화정보 (교육/체험) 목록조회	한눈에보는문화정보(교육/체험) 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/education
문화기관정보(공지사항) 목록조회	문화기관정보(공지사항) 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/cultureinformation/notice

개발가이드 다운로드

문화정보 조회서비스 개발가이드 https://www.culture.go.kr/guide/docs/cis_guide.zip

에러메시지

00 : NORMAL SERVICE
01 : APPLICATION ERROR
02 : DB_ERROR
03 : NODATA ERROR
04 : HTTP ERROR
05 : SERVICETIMEOUT ERROR
10 : INVALID REQUEST PARAMETER ERROR
11 : MANDATORY REQUEST PARAMETERS ERROR
12 : NO OPENAPI SERVICE ERROR
20 : SERVICE ACCESS DENIED ERROR
21 : TEMPORARILY DISABLE THE SERVICEKEY ERROR
22 : LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS ERROR
30 : SERVICE KEY IS NOT REGISTERED ERROR
31 : DEADLINE HAS EXPIRED ERROR
32 : UNREGISTERED IP ERROR
33 : UNSIGNED CALL ERROR
99 : UNKNOWN ERROR

한국의문양 조회서비스

한국의문양 조회서비스는 한국의문양에 대한 검색 결과를 외부에 REST방식으로 전달하는 API서비스이다.

오퍼레이션 목록

오퍼레이션 목록
오퍼레이션	서비스 내용	전송방식	요청URL
2D개별문양 목록조회	2D개별문양 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/koreanpattern/individualizations/2d
3D개별문양 목록조회	3D개별문양 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/koreanpattern/individualizations/3d
개별문양 상세정보조회	개별문양 상세정보를 조회한다.	REST	http://www.culture.go.kr/openapi/rest/koreanpattern/individualizations/d/?did={개별문양번호}
원시문양 목록조회	원시문양 목록을 조회한다.	REST	http://www.culture.go.kr/openapi/rest/koreanpattern/raws
원시문양 상세정보조회	원시문양 상세정보를 조회한다.	REST	http://www.culture.go.kr/openapi/rest/koreanpattern/raws/d/?did={원시문양번호}