기록정보서비스>이용안내>검색가이드>OpenAPI사용법

본문으로 이동

검색가이드

기록물 상세검색검색가이드

기록물 상세검색 조건을 서술하는 표입니다. 검색방식, 검생영역, 검색어설정, 생산기관, 생산연도, 공개구분, 원문서비스 ,기록물형태, 관리번호, 철건구분, 기록물구분, 목록건수 순으로 구성되어 있습니다.
검색방식	키워드검색 전후방일치검색 ※ 키워드 검색 : 문장 내 형태적 의미가 있는 단어만 검색 ※ 전후방일치검색 : 형태적 의미와 상관없이 모두 검색
검색영역	전체 기록물 제목 기록물 정보 기록물 정보 : 기록물 제목 외에 내용 요약, 명칭, 지명, 검색 키워드 영역 내에서 검색
검색어 설정	다음 단어 모두 포함 한자검색 포함 다음 문구 정확하게 포함 다음 단어 적어도 하나 포함 다음 단어 제외
생산기관	생산기관검색	생산연도 생산연도 두번째	~ 예) 1900~2010
공개구분	전체 공개 부분공개 비공개 공개에 한해서만 사본/열람신청이 가능합니다.
원문서비스	전체 온라인제공 온라인 미제공 온라인으로 원문제공이 가능한 기록물만 조회할 수 있습니다.
전자 / 비전자 구분	전체 전자 비전자
기록물형태	전체 일반문서 사진,필름류 녹음,동영상류 도면 카드류 국무회의록 정부간행물 일반도서 총독부간행물
관리번호	관리번호관리번호두번째 ~ 예) CM00020005	철건구분
기록물구분		목록건수
생산등록일자 생산등록일자 두번째	~ 예) 1900101~20100101	시행일자 시행일자 두번째	~ 예) 1900101~20100101

기록물 원문검색

기본검색

원문이미지를 제공하는 기록물들을 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

공공누리

원문이미지를 제공하는 기록물들을 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

토지기록물

일제강점기부터 정부수립 직후까지 생산된 토지 임야대장, 지적ㆍ임야원도 등 지적 기록물을 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

토지 기록물 검색 조건표
지명	시·군·구 등과 행정구역은 입력하지 마세요. 예)강화군(x)→강화
종류	전체 지적원도 임야원도 토지조사부 임야조사부 분배농지관련문서 사방사업관련문서 보안림
생산년도	~

관보

정부에서 발행한 관보를 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

관보검색 조건표
키워드	검색어 ※ 조선총독부 관보 검색시 에는 키워드를 한자로 변환 하여 입력해 주시기 바랍니다.
게제의뢰기관	기관검색
발행날짜	~
관보종류

국무회의록

국무회의록, 차관회의록, 안건철 등 국무회의 기록을 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

국무회의록검색 조건표
키워드	검색어
의안종별
회차	~
기록물 종류	전체 국무회의록 국무회의안건철 차관회의록 차관회의안건철 기타
시청각 종류	전체 동영상 녹취 사진 ※ 시청각기록물 검색시 체크하세요.

정부간행물

공공기관에서 발행한 간행물을 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

정부간행물검색 조건표
키워드	검색어
발행기관	발행기관명 기관검색
발행년도	발행년도 검색 시작년도발행년도 검색 종료년도 ~ 예) 1900~2010
간행물 유형	전체 연감.백서류 통계집 업무편람 법규집 사업보고서 교육자료 기관지 회의자료 목록류 사료연혁집 연구조사보고서 연설.강연집 전시.도감.화보집 기타(유형 미표시 기록물 포함)

독립운동 판결문

일제강점기 독립운동과 관련된 판결문을 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

독립운동 판결문 검색 조건표
키워드	검색어
이름/별명	이름/별명
판결기관	판결기관 기관검색
판결날짜	~

일제강점기 피해자명부

3.1운동 피살자, 관동대지진 피살자 명부를 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

일제강점기 피해자명부 검색 조건표
명부
성명	성명
등록시 본적지	등록시 본적지

일제강점기 건축도면

일제강점기에 지어진 학교, 형무소, 병원, 지방청사 등의 설계원도를 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

일제강점기 건축도면 검색 조건표
키워드	검색어
공사유형	전체 지적도 지형도 배치도 평면도 입면도 단면도 상세 건구표 꼬리표 분류표 도장 싸인 기타
도면종류	전체 지적도 지형도 배치도 평면도 입면도 단면도 상세 건구표 꼬리표 분류표 도장 싸인 기타
생산년도	~

일제강점기 기록물

정부에서 발행한 관보를 검색하실 수 있습니다.

단어와 단어를 조합하여 정확한 검색을 하고 싶을 때 :
“ ^ ” (Shift+6)를 사용 하세요.
단어와 단어를 조합하여 좀 더 폭넓게 검색하고 싶을 때 :
스페이스바를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ “” ”를 사용 하세요.
특정단어로 시작하는 단어가 포함된 문서를 검색하고 싶을 때 :
“ * ” (Shift+8)를 사용 하세요.
특정단어를 제외하고 검색하고 싶을 때 :
“ | ”를 사용 하세요.

일제강점기 기록물 검색 조건표
키워드
생산 년도	~
생산기관
분야선택	전체 지방행정 경무 외사 이재 사계 상공 경금속 연료 노무 학무 사회교육 건축회계 세무 위생 법무 지방행정 토지개량 수리조합 토목 임정 광무 미곡 산금 인사 편집 행형

OpenAPI 사용법

나라기록물 검색서비스 OpenAPI 소개

국가기록원에서는 나라기록물 검색 서비스 OpenAPI 제공을 통해 IT 환경의 변화 속에서 기존의 복잡하고 비용이 높은 웹서비스 대신 개방형, 경량화 연계 지원으로 국민과 기업이 가치를 창출할 수 있도록 지원하고자 합니다.
나라기록물 검색서비스 OpenAPI는 기록물에 대한 검색 결과를 RSS형식으로 전달하는 API서비스이며, OpenAPI를 통한 질의건수는 하루 사용량 1,000건 미만으로 제한하고 있습니다.
질의건수 제한없이 OpenAPI를 사용하시려면, 국가기록원 담당자(서비스정책과, 031-750-2026)에게 별도 문의하여 주시기 바랍니다.

이용방법

1. 인증키 발급 받기

나라기록물 검색서비스 OpenAPI를 이용하시려면, 인증키가 필요합니다.
- 인증키 : API 서비스 이용 승낙을 받은 기관 또는 이용자임을 식별할 수 있는 고유 값
인증키를 발급 받기 위해 공공데이터 포털(www.data.go.kr)에 가입하시기 바랍니다.
- 가입 후, 아래와 같이 ‘데이터셋-오픈 API’ 메뉴에서 ‘나라기록물 검색 서비스’를 검색하셔서 제목을 클릭하신 후 개발계정을 신청하셔야 합니다.
- 이후, 인증키 발급 절차는 아래의 ‘Open API 인증키 발급 안내’ 클릭 후, ‘2. 공공데이터 활용방법>2-2 오픈 API’의 페이지 중간 ‘오픈 API 활용신청’의 개발계정 신청 단계부터 참고하여 진행하시기 바랍니다.
  Open API 인증키 발급 안내 바로가기

2. 인증키 테스트

아래 입력창에 발급받은 인증키를 입력하여 정상 인증키인지 확인하실 수 있습니다.

API 테스트 항목내용 안내 상세정보 입니다
인증키 입력	인증키 (디코딩): 확인
정상 테스트 화면

아래 입력창에 발급받은 인증키를 입력하여 정상 인증키인지 확인하실 수 있습니다.

요청 주소 안내 상세정보 입니다
요청 주소	https://search.archives.go.kr/openapi/search.arc?serviceKey=인증키(인코딩)&query=검색어(UTF-8)

1) 요청 변수(request parameter)

요청 변수 - 요청변수, 필수유무, 설명으로 구성되어 있습니다.
요청변수	필수	설명
key	O	OpenAPI 사용 인증키, UTF-8 인코딩입니다.
query	O	검색을 원하는 질의, UTF-8 인코딩입니다.
rc_type		철건 구분 [철:rfile, 건:ritem]
display		한 페이지에 출력될 결과수
pageno		조회페이지

2) 출력 결과 필드 (response field)

출력 결과 필드 상세정보 입니다. 필드, 값, 설명으로 구성되어 있습니다.
필드	설명
channel	검색 결과를 포함하는 컨테이너입니다.
title	API 제목(국가기록원 오픈 API 검색결과)
total	검색 결과 문서의 총 개수를 의미합니다.
rc_type	기록물구분값 (RFILE:철 RITEM:건)
rc_code	기관구분값
rc_rfile_no	기록물 철ID
rc_ritem_no	기록물 건ID
title	기록물 제목
mgt_org_name	기여자 정보
prod_name	생산기관
prod_year	생산년도
is_open	공개구분값 (1:공개 2:부분공개 3:비공개)
arcave_type	기록물 구분 (01:일반기록물, 02:시청각기록물,04:총독부기록물, 05:정부간행물, 06:해외기록물, 07:역사기록물, 08:행정박물, 09:민간기록물, 10:영화필름, 11:방송프로그램, 12:구술기록)
doc_type	기록물 형태 (1:행정박물(관인류), 2:행정박물(상징기념물), 3:행정박물(사무집기류), 4:행정박물(기타), A:일반문서류, B:도면류, C:사진,필름류, D:녹음,동영상류, E:카드류, F:대장류, G:국무회의록, H:지도, M:정부간행물, O:일반도서, P:총독부간행물)
online_reading	원문온라인열람서비스 (Y : 가능 , N : 불가)
link	기록물 상세정보페이지 링크

3) 에러 메세지

에러 메세지 상세정보 입니다. 필드, 값, 설명으로 구성되어 있습니다.
0001	System error. 시스템에러가 발생했습니다.
1001	Unregistered Key. 등록되지 않은 인증키입니다.
2001	No Query Value. 주 검색질의어(query value)가 없습니다.
3001	Query Count is over the Limit. 허용된 최대 검색허용 횟수를 초과 했습니다.
9001	Unknown Error 정의되지 않은 오류가 발생했습니다. (구체적인 에러 표시)