본문

Open API 개방목록

안내사항

오픈API 소개

오픈API란 누구나 사용할 수 있도록 공개된 API를 말합니다. 데이터를 표준화하고 프로그래밍해 외부 소프트웨어 개발자나 사용자들과 공유하는 프로그램입니다. 개방된 오픈API를 이용해 다양하고 재미있는 서비스나 애플리케이션, 다양한 형태의 플랫폼을 개발할 수 있습니다.

*API란?  Application Programming Interface의 약자로 응용 프로그램 프로그래밍 인터페이스를 말합니다. 다양한 응용 프로그램에 사용할 수 있는 운영 체제, 혹은 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스입니다.

오픈API(문화유산 정보조회 서비스) → 개발자 → 문화유산 정보 관련 앱 → 사용자
문화유산 앱개발

앱활용정보

참고사항
API 사용에 대한 참고사항입니다. 종목코드와 시도코드를 확인하세요
종목코드 11 : 국보   12 : 보물   13 : 사적   14 : 사적및명승   15 : 명승   16 : 천연기념물   17 : 국가무형문화재   18 : 국가민속문화재
21 : 시도유형문화재   22 : 시도무형문화재   23 : 시도기념물   24 : 시도민속문화재   25 : 시도등록문화재   31 : 문화재자료
79 : 국가등록문화재   80 : 이북5도 무형문화재
지정번호 예) 서울 숭례문 국보 제1호 : 00010000
       동해안별신굿 국가무형문화재 제82-1호 : 00820100
       동국지도서애선생수택본 보물 제460-1-7호 : 04600107
시도코드 11 : 서울   21 : 부산   22 : 대구   23 : 인천   24 : 광주   25 : 대전   26 : 울산   45 : 세종   31 : 경기   32 : 강원   33 : 충북   34 : 충남   35 : 전북   36 : 전남   37 : 경북   38 : 경남   50 : 제주   ZZ : 전국일원
시군구코드
시군구 조회 OPEN API 목록 정보입니다.
OPEN API URL http://www.cha.go.kr/common/heritage/selectSearchGugunCdOpenApi.jsp
필수파라미터 ccbaCtcd(시도코드) / 데이터 타입 - String
※ 해당 표의 시도코드 참고하세요.
행사구분 01 : 문화재야행    02 : 생생문화재   03 : 전통산사문화재    04 : 살아숨쉬는 향교·서원   07 : 국립무형유산원   08 : 한국문화재재단   09 : 고택·종갓집   10 : 세계유산   06 : 기타행사

문화재 정보 OPEN API 현황
문화유산소식 OPEN API 목록 정보입니다.
종류 OPEN API URL
문화재검색 목록 http://www.cha.go.kr/cha/SearchKindOpenapiList.do
문화재검색 상세 http://www.cha.go.kr/cha/SearchKindOpenapiDt.do
문화재검색 목록조회 : 요청 파라미터 (Request Parameter)
문화재검색 목록조회 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 지정종목별
stCcbaAsdt int 지정연도 시작
enCcbaAsdt int 지정연도 끝
ccbaMnm1 String 문화재명(국문)
ccbaCtcd String 시도코드
ccbaLcto String 시군구코드
※ 시도코드(ccbaCtcd) 필수
ccbaPcd1 String 시대
startNum String 지정번호 시작
endNum String 지정번호 끝
ccbaCpno String 문화재연계번호
ccbaCncl String 지정해제여부 (Y, N)
pageUnit int 페이징 처리 시 페이지당 건 수
pageIndex int 조회할 페이지 숫자

문화재검색 목록조회 : 결과 파라미터 (Response Parameter)
문화재검색 목록조회 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
totalCnt int 조회된 총 데이터 건 수
pageUnit int 페이징 처리 시 페이지당 건 수
pageIndex int 조회할 페이지 숫자
sn int 순번
no int 고유 키값
ccmaName String 문화재종목
crltsnoNm int 지정호수
ccbaMnm1 String 문화재명(국문)
ccbaMnm2 String 문화재명(한자)
ccbaCtcdNm String 시도명
ccsiName String 시군구명
ccbaAdmin String 관리자
ccbaKdcd String 종목코드
ccbaCtcd String 시도코드
ccbaAsno String 지정번호
ccbaCncl String 지정해제여부
ccbaCpno String 문화재연계번호
longitude String 경도 ( 0일 경우 : 위치 값 없음 )
latitude String 위도 ( 0일 경우 : 위치 값 없음 )

문화재검색 상세조회 : 요청 파라미터 (Request Parameter)
문화재검색 상세조회 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드(필수)
ccbaAsno String 지정번호(필수)
ccbaCtcd String 시도코드(필수)

문화재검색 상세조회 : 결과 파라미터 (Response Parameter)
문화재검색 상세조회 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드
ccbaAsno String 지정번호
ccbaCtcd String 시도코드
ccbaCpno String 문화재연계번호
longitude String 경도 ( 0일 경우 : 위치 값 없음 )
latitude String 위도 ( 0일 경우 : 위치 값 없음 )
ccmaName String 문화재종목
gcodeName String 문화재분류
bcodeName String 문화재분류2
mcodeName String 문화재분류3
scodeName String 문화재분류4
ccbaQuan String 수량
ccbaAsdt String 지정(등록일)
ccbaLcad String 소재지 상세
ccceName String 시대
ccbaPoss String 소유자
ccbaAdmin String 관리자
imageUrl String 메인노출이미지URL
content String 내용

문화재 정보 OPEN API 현황
문화유산소식 OPEN API 목록 정보입니다.
종류 OPEN API URL
문화재 이미지검색 http://www.cha.go.kr/cha/SearchImageOpenapi.do
문화재 동영상검색 http://www.cha.go.kr/cha/SearchVideoOpenapi.do
문화재 나레이션검색 http://www.cha.go.kr/cha/SearchVoiceOpenapi.do
문화재이미지검색 : 요청 파라미터 (Request Parameter)
문화재이미지검색 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드(필수)
ccbaAsno String 지정번호(필수)
ccbaCtcd String 시도코드(필수)

문화재이미지검색 : 결과 파라미터 (Response Parameter)
문화재이미지검색 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
totalCnt int 전체갯수
ccbaKdcd String 종목코드
ccbaAsno String 지정번호
ccbaCtcd String 시도코드
ccbaMnm1 String 문화재명(국문)
ccbaMnm2 String 문화재명(한자)
sn int 순번
imageNuri String 공공누리 타입
A : 제1유형, B : 제2유형, C : 제3유형, D : 제4유형

공공누리 유형안내 - https://www.kogl.or.kr/info/license.do
imageUrl String 메인노출이미지URL
ccimDesc String 이미지설명

문화재동영상검색 : 요청 파라미터 (Request Parameter)
문화재동영상검색 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드(필수)
ccbaAsno String 지정번호(필수)
ccbaCtcd String 시도코드(필수)

문화재동영상검색 : 결과 파라미터 (Response Parameter)
문화재동영상검색 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
totalCnt int 전체갯수
ccbaKdcd String 종목코드
ccbaAsno String 지정번호
ccbaCtcd String 시도코드
ccbaMnm1 String 문화재명(국문)
ccbaMnm2 String 문화재명(한자)
sn int 순번
videoUrl String 동영상URL

문화재나레이션검색 : 요청 파라미터 (Request Parameter)
문화재나레이션검색 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
ccbaKdcd String 종목코드(필수)
ccbaAsno String 지정번호(필수)
ccbaCtcd String 시도코드(필수)
ccbaGbn String 국가구분(나레이션 검색 필수)
kr:국문, en:영문, jpn:일문, chn:중문

문화재나레이션검색 : 결과 파라미터 (Response Parameter)
문화재나레이션검색 API 결과 파라미터 (Response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
totalCnt int 전체갯수
ccbaKdcd String 종목코드
ccbaAsno String 지정번호
ccbaCtcd String 시도코드
ccbaMnm1 String 문화재명(국문)
ccbaMnm2 String 문화재명(한자)
sn int 순번
voiceUrl String 나레이션URL
문화재 행사목록 : 요청 파라미터 (Request Parameter)
문화재 행사목록 API 요청 파라미터 (Request Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
searchYear String 검색연도(필수)
searchMonth String 검색월(필수)
searchWrd String 행사명(선택)
siteCode String 행사구분(선택)
문화재 행사목록 : 결과 파라미터 (response Parameter)
문화재 행사목록 API 결과 파라미터 (response Parameter) Parameter, 데이터타입, 내용을 제공
Parameter 데이터타입 내용
seqNo int 일련번호
siteCode String 행사구분
subTitle String 프로그램명
subContent String 프로그램내용
sDate String 시작일자
eDate String 종료일자
groupName String 그룹명
contact String 문의
subDesc String 장소
subPath String 경로
subDesc1 String 참여대상
subDesc2 String 기타
mainImageTemp String 이미지저장이름
sido String 시도
gugun String 시군구
subDate String 일정기간
fileNm String 상위노드(imgFile) : 이미지파일명
상위노드(downFile) : 첨부파일명
filePath String 상위노드(imgFile) : 이미지파일 경로
상위노드(downFile) : 첨부파일 경로
만족도조사
유용한 정보가 되셨나요?
만족도조사선택 확인
메뉴담당자 : 정보화담당관실
페이지상단 바로가기