메뉴펼쳐보기
홈문화지식문화포털 API

문화포털 API

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

문화포털 오픈 API 정의

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

문화포털 오픈 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 정보제공
오퍼레이션 서비스 내용 전송방식 요청 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={공연/전시번호}
개발가이드 다운로드

공연전시정보조회서비스 개발가이드 : http://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 정보제공
오퍼레이션 서비스 내용 전송방식 요청 URL
홍보마당 목록조회 홍보마당 목록을 조회한다. REST http://www.culture.go.kr/openapi/rest/publicrelations
홍보마당 상세정보조회 홍보마당 상세정보를 조회한다. REST http://www.culture.go.kr/openapi/rest/publicrelations/d/?seq={홍보마당번호}
개발가이드 다운로드

홍보마당조회서비스 개발가이드 : http://www.culture.go.kr/guide/docs/prs_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 정보제공
오퍼레이션 서비스 내용 전송방식 요청 URL
공연장정보 목록조회 공연장정보 목록을 조회한다. REST http://www.culture.go.kr/openapi/rest/cultureartspaces/performingplace
미술관정보 목록조회 미술관정보 목록을 조회한다. REST http://www.culture.go.kr/openapi/rest/cultureartspaces/artgallery
박물관정보 목록조회 박물관정보 목록을 조회한다. REST http://www.culture.go.kr/openapi/rest/cultureartspaces/museum
문화/복지 시군구회관 정보목록조회 문화/복지 시군구회관 정보목록을 조회한다. 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={공간번호}
개발가이드 다운로드

문화예술공간조회서비스 개발가이드 : http://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 정보제공
오퍼레이션 서비스 내용 전송방식 요청 URL
문화 Newsletter 목록조회 문화 Newsletter 목록을 조회한다. 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
개발가이드 다운로드

문화정보 조회서비스 개발가이드 : http://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 정보제공
오퍼레이션 서비스 내용 전송방식 요청 URL
예술지식용어 사전목록조회 예술지식용어사전 목록을 조회한다 REST http://www.culture.go.kr/openapi/rest/artworddictionaries
예술지식 용어사전 상세정보조회 예술지식용어사전 상세정보를 조회한다. REST http://www.culture.go.kr/openapi/rest/artworddictionaries/d/?id={용어번호}
개발가이드 다운로드

예술용어사전 조회서비스 개발가이드 : http://www.culture.go.kr/guide/docs/ads_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 정보제공
오퍼레이션 서비스 내용 전송방식 요청 URL
티켓할인 목록조회 티켓할인 목록을 조회한다. REST http://www.culture.go.kr/openapi/rest/ticketdiscounts
티켓할인 상세정보조회 티켓할인 상세정보를 조회한다. REST http://www.culture.go.kr/openapi/rest/ticketdiscounts/d/?seq={티켓번호}
개발가이드 다운로드

문화예술공간조회서비스 개발가이드 : http://www.culture.go.kr/guide/docs/gtds_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 정보제공
오퍼레이션 서비스 내용 전송방식 요청 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={원시문양번호}
개발가이드 다운로드

한국의문양 조회서비스 개발가이드 : http://www.culture.go.kr/guide/docs/kps_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

관련기관 안내