본문 바로가기 푸터 바로가기
> 문화알리미 문화포털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
기간별공연 전시목록조회 기간별공연/전시 목록을 조회한다. 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

에러메시지

  1. 00 : NORMAL SERVICE
  2. 01 : APPLICATION ERROR
  3. 02 : DB_ERROR
  4. 03 : NODATA ERROR
  5. 04 : HTTP ERROR
  6. 05 : SERVICETIMEOUT ERROR
  7. 10 : INVALID REQUEST PARAMETER ERROR
  8. 11 : MANDATORY REQUEST PARAMETERS ERROR
  9. 12 : NO OPENAPI SERVICE ERROR
  10. 20 : SERVICE ACCESS DENIED ERROR
  11. 21 : TEMPORARILY DISABLE THE SERVICEKEY ERROR
  12. 22 : LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS ERROR
  13. 30 : SERVICE KEY IS NOT REGISTERED ERROR
  14. 31 : DEADLINE HAS EXPIRED ERROR
  15. 32 : UNREGISTERED IP ERROR
  16. 33 : UNSIGNED CALL ERROR
  17. 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

에러메시지

  1. 00 : NORMAL SERVICE
  2. 01 : APPLICATION ERROR
  3. 02 : DB_ERROR
  4. 03 : NODATA ERROR
  5. 04 : HTTP ERROR
  6. 05 : SERVICETIMEOUT ERROR
  7. 10 : INVALID REQUEST PARAMETER ERROR
  8. 11 : MANDATORY REQUEST PARAMETERS ERROR
  9. 12 : NO OPENAPI SERVICE ERROR
  10. 20 : SERVICE ACCESS DENIED ERROR
  11. 21 : TEMPORARILY DISABLE THE SERVICEKEY ERROR
  12. 22 : LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS ERROR
  13. 30 : SERVICE KEY IS NOT REGISTERED ERROR
  14. 31 : DEADLINE HAS EXPIRED ERROR
  15. 32 : UNREGISTERED IP ERROR
  16. 33 : UNSIGNED CALL ERROR
  17. 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

에러메시지

  1. 00 : NORMAL SERVICE
  2. 01 : APPLICATION ERROR
  3. 02 : DB_ERROR
  4. 03 : NODATA ERROR
  5. 04 : HTTP ERROR
  6. 05 : SERVICETIMEOUT ERROR
  7. 10 : INVALID REQUEST PARAMETER ERROR
  8. 11 : MANDATORY REQUEST PARAMETERS ERROR
  9. 12 : NO OPENAPI SERVICE ERROR
  10. 20 : SERVICE ACCESS DENIED ERROR
  11. 21 : TEMPORARILY DISABLE THE SERVICEKEY ERROR
  12. 22 : LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS ERROR
  13. 30 : SERVICE KEY IS NOT REGISTERED ERROR
  14. 31 : DEADLINE HAS EXPIRED ERROR
  15. 32 : UNREGISTERED IP ERROR
  16. 33 : UNSIGNED CALL ERROR
  17. 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={원시문양번호}

개발가이드 다운로드

한국의 문양 조회서비스 개발가이드 https://www.culture.go.kr/guide/docs/kps_guide.zip

에러메시지

  1. 00 : NORMAL SERVICE
  2. 01 : APPLICATION ERROR
  3. 02 : DB_ERROR
  4. 03 : NODATA ERROR
  5. 04 : HTTP ERROR
  6. 05 : SERVICETIMEOUT ERROR
  7. 10 : INVALID REQUEST PARAMETER ERROR
  8. 11 : MANDATORY REQUEST PARAMETERS ERROR
  9. 12 : NO OPENAPI SERVICE ERROR
  10. 20 : SERVICE ACCESS DENIED ERROR
  11. 21 : TEMPORARILY DISABLE THE SERVICEKEY ERROR
  12. 22 : LIMITED NUMBER OF SERVICE REQUESTS EXCEEDS ERROR
  13. 30 : SERVICE KEY IS NOT REGISTERED ERROR
  14. 31 : DEADLINE HAS EXPIRED ERROR
  15. 32 : UNREGISTERED IP ERROR
  16. 33 : UNSIGNED CALL ERROR
  17. 99 : UNKNOWN ERROR