---
description: 이 문서는 연구데이터 검색 API 서비스를 소개합니다.
---

# 연구데이터 검색 API

## 개요

연구데이터 검색 API는 연구데이터  통합 검색결과를 API로 실행할 수 있게 하는 RESTful API입니다.

### **요청 URL**&#x20;

```
	https//dataon.kisti.re.kr/rest/api/search/dataset/
```

### **프로토콜**&#x20;

HTTPS

### **HTTP 메서드**&#x20;

GET/POST

### **요청 파라미터**&#x20;

| **파라미터(영문)** | **타입** |  **필수항목** | **설명**      | **예**                           |
| ------------ | ------ | :-------: | ----------- | ------------------------------- |
| key          | CHAR   |   **Y**   | 승인된 발급키     | DF7B7BE61ACF98D21EE71EAA21AB173 |
| query        | CHAR   |   **Y**   | 검색하기 위한 키워드 | 데이터                             |
| from         | CHAR   |     N     | 페이지시작위치     | 0                               |
| size         | CHAR   |     N     | 페이지사이즈      | 10                              |

### 요청 예

{% hint style="danger" %}
**key는 발급받은 인증키를 사용하셔야 합니다.**&#x20;
{% endhint %}

* **key는 발급받은 인증키를 사용하셔야 합니다.**&#x20;

```
https://dataon.kisti.re.kr/rest/api/search/dataset?key=91EF0AA92005F44182A6DD1F0A404CFA&query=covid%20virus&from=1000&size=1
```

### 응답 파라미터

| **파라미터(영문)**                | **속성** | **반복** | **설명**        | **예**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------------- | ------ | ------ | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| svc\_id                     |        |        | 서비스 ID        | <p>473373a5bfef2c56632ea0be</p><p>f204e955</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ctlg\_type                  |        |        | 자료유형 코드       | <p>01:collection </p><p>02:dataset </p><p>03:file </p><p>04:image_nrms </p><p>05:software </p><p>06:workflow </p><p>07:model </p><p>08:image</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| dataset\_type               |        |        | 국내외구분코드       | <p>01:국내 </p><p>02:국외</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ctlg\_type\_pc              |        |        | 자료유형          | <p>collection </p><p>dataset </p><p>file </p><p>image_nrms </p><p>software</p><p>workflow </p><p>model </p><p>image</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| dataset\_type\_pc           |        |        | 국내외구분         | 국내,해외                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| dataset\_pub\_dt\_pc        |        |        | 등록년도          | 2017년,..                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| dataset\_access\_type\_pc   |        |        | 접근권한          | <p>공개 </p><p>비공개 <br>엠바고</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| file\_yn\_pc                |        |        | 파일접근방법        | <p>랜딩페이지이동, </p><p>직접다운로드</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| dataset\_cc\_license\_pc    |        |        | 라이센스유형        | CC-BY,..                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| dataset\_main\_lang\_pc     |        |        | 작성언어          | English,...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| dataset\_sub\_lang\_pc      |        |        | 작성부언어         | none,English,...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| cltfm\_pc                   |        |        | 데이터 제공처       | 국가R\&D보고서등록관리시스템                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| dataset\_title\_kor         |        |        | 제목\_한글        | 금속소재 고온 인장물성                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| dataset\_title\_etc\_main   |        |        | 제목\_다국어(주언어)  | 고등균류 DB                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| dataset\_title\_etc\_sub    |        |        | 제목\_다국어(부언어)  | Korean Mushroom DB                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| dataset\_expl\_kor          |        |        | 내용\_한글        | 1.한국의 버섯의 종류                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| dataset\_expl\_etc\_main    |        |        | 내용\_다국어(주언어)  | 1.한국의 버섯의 종류                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| dataset\_expl\_etc\_sub     |        |        | 내용\_다국어(부언어)  | 1.Types of mushrooms in Korea                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| dataset\_kywd\_kor          |        |        | 키워드\_한글       | 버섯                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| dataset\_kywd\_etc\_main    |        |        | 키워드\_다국어(주언어) | 버섯                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| dataset\_kywd\_etc\_sub     |        |        | 키워드\_다국어(부언어) | mushroom                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| cltfm\_kor                  |        |        | 수집처\_한글       | 국가R\&D보고서등록관리시스템                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| cltfm\_etc                  |        |        | 수집처\_다국어      | <p>National R&#x26;D Reports </p><p>Management System</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| dataset\_data\_loc          |        |        | 데이터수집지역       | {type:point,coordinates:\[0,0]}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| dataset\_lndgpg             |        |        | 데이터제공처링크      | [http://mushroom.ndsl.kr](http://mushroom.ndsl.kr)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| dataset\_lndgpg\_img        |        |        | 이미지 데이터 URL   | <p><a href="https://nrms.kisti.re.kr/bitextimages/TRKO201700007162/TRKO201700007162_205_image_1.png">https://nrms.kisti.re.kr/</a></p><p><a href="https://nrms.kisti.re.kr/bitextimages/TRKO201700007162/TRKO201700007162_205_image_1.png">bitextimages/</a></p><p><a href="https://nrms.kisti.re.kr/bitextimages/TRKO201700007162/TRKO201700007162_205_image_1.png">TRKO201700007162/</a></p><p><a href="https://nrms.kisti.re.kr/bitextimages/TRKO201700007162/TRKO201700007162_205_image_1.png">TRKO20170000716</a></p><p><a href="https://nrms.kisti.re.kr/bitextimages/TRKO201700007162/TRKO201700007162_205_image_1.png">2_205_image_1.png</a></p> |
| dataset\_lndgpg\_thum       |        |        | 데이터셋 썸네일 URL  | <p><a href="https://do2020.kisti.re.kr/canvas/rest/app/software/46/thumbnail">https://do2020.kisti.re.kr/</a></p><p><a href="https://do2020.kisti.re.kr/canvas/rest/app/software/46/thumbnail">canvas/</a><a href="https://do2020.kisti.re.kr/canvas/rest/app/software/46/thumbnail">rest/app/software/</a></p><p><a href="https://do2020.kisti.re.kr/canvas/rest/app/software/46/thumbnail">46/thumbnail</a></p>                                                                                                                                                                                                                                        |
| dataset\_doi                |        |        | DOI           | 10.8888/EPOPS2018111412Q                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| dataset\_etc\_attr          |        |        | 기타정보          | json                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| dataset\_regist\_dt         |        |        | 시스템 등록일자      | 2020-09-25 00:50:40                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| dataset\_mod\_dt            |        |        | 시스템 갱신일자      | 0001-01-01 00:00:00                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| dataset\_mnsb\_pc           |        |        | 주제분류          | 생물과학                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| file\_frmt\_pc              |        |        | 파일유형          | png                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| repo\_pc                    |        |        | 데이터 리포지터리     | 국가R\&D보고서등록관리시스템                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| pjt\_prfrm\_org\_pc         |        |        | 과제수행기관        | 한국과학기술정보연구원                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ministry\_pc                |        |        | 부처            | 과학기술정보통신부                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| dataset\_creator\_kor       |        |        | 생성자\_한글       | 홍길동                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| dataset\_creator\_etc\_main |        |        | 생성자\_다국어(주언어) | 홍길동                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| dataset\_creator\_etc\_sub  |        |        | 생성자\_다국어(부언어) | Hong Gil Dong                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| pjt\_prfrm\_org\_kor        |        |        | 과제수행기관\_한글    | 한국과학기술정보연구원                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| pjt\_prfrm\_org\_etc        |        |        | 과제수행기관\_다국어   | KISTI                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ministry\_kor               |        |        | 부처\_한글        | 과학기술정보통신부                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ministry\_etc               |        |        | 부처\_다국어       | Ministry of Science and ICT                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| repo\_kor                   |        |        | 리포지터리\_한글     | 한국과학기술정보연구원                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| repo\_etc                   |        |        | 리포지터리\_다국어    | <p>Korea Institute of Science </p><p>and Technology Information</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| pjt\_nm\_kor                |        |        | 과제명\_한글       | <p>국가연구데이터 플랫폼 </p><p>구축 및 운영</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| pjt\_nm\_etc                |        |        | 과제명\_다국어      | <p>Construction and Operation </p><p>of National Research data platform</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| pjt\_mngr\_kor              |        |        | 과제책임자\_한글     | 홍길동                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| pjt\_mngr\_etc              |        |        | 과제책임자\_다국어    | Hong Gil Dong                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| pjt\_prtpnt\_kor            |        |        | 과제참여자\_한글     | 홍길동                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| pjt\_prtpnt\_etc            |        |        | 과제참여자\_다국어    | Hong Gil Dong                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| dataset\_cntrbtr\_kor       |        |        | 기여자\_한글       | 홍길동                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| dataset\_cntrbtr\_etc       |        |        | 기여자\_다국어      | Hong Gil Dong                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| dataset\_pblshr             |        |        | 발행기관          | 한국과학기술정보연구원                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| dataset\_pric               |        |        | 담당자           | 홍길동                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| rrno                        |        |        | 국가연구자번호       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ntisno                      |        |        | NTIS과제번호      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

### 응답 예&#x20;

```
{
	"response": {
		"elapsed time": "30 ms",
		"status": "200",
		"message": "OK",
		"total count": 4961,
		"type": "json",
		"key": "91EF0AA92005F44182A6DD1F0A404CFA",
		"query": "covid virus",
		"from": 1000,
		"size": 2
	},
	"records": [{
			"svc_id": "a89c4b976180ecffb74924cc337e9a2c",
			"ctlg_type": "02",
			"dataset_type": "02",
			"ctlg_type_pc": "dataset",
			"dataset_type_pc": "해외",
			"dataset_pub_dt_pc": "2018",
			"dataset_access_type_pc": "공개",
			"file_yn_pc": "랜딩페이지이동",
			"dataset_cc_license_pc": "none",
			"dataset_main_lang_pc": "English",
			"dataset_sub_lang_pc": "none",
			"cltfm_pc": "OpenAIRE",
			"dataset_title_kor": "",
			"dataset_title_etc_main": "Virus alignments found in human cancer - aidinfo table",
			"dataset_title_etc_sub": "",
			"dataset_expl_kor": "",
			"dataset_expl_etc_main": "<p>The file contains one row for every analysis_id (column name &#39;aid&#39;) analyzed for the paper. An analysis_id is a unique TCGA BAM file.</p>",
			"dataset_expl_etc_sub": "",
			"dataset_kywd_kor": "",
			"dataset_kywd_etc_main": "",
			"dataset_kywd_etc_sub": "",
			"cltfm_kor": "",
			"cltfm_etc": "OpenAIRE",
			"dataset_data_loc": "{type:point,coordinates:[0,0]}",
			"dataset_lndgpg": "https://doi.org/10.5281/zenodo.3668362",
			"dataset_lndgpg_img": "",
			"dataset_lndgpg_thum": "",
			"dataset_doi": "10.5281/zenodo.3668362",
			"dataset_etc_attr": "",
			"dataset_regist_dt": "2020-11-24 01:43:13",
			"dataset_mod_dt": "2020-11-25 19:33:48",
			"dataset_mnsb_pc": ["none"],
			"file_frmt_pc": ["none"],
			"repo_pc": ["Zenodo"],
			"pjt_prfrm_org_pc": ["none"],
			"ministry_pc": ["none"],
			"dataset_creator_kor": [""],
			"dataset_creator_etc_main": [""],
			"dataset_creator_etc_sub": [""],
			"pjt_prfrm_org_kor": [""],
			"pjt_prfrm_org_etc": [""],
			"ministry_kor": [""],
			"ministry_etc": [""],
			"repo_kor": [""],
			"repo_etc": ["Zenodo"],
			"pjt_nm_kor": [""],
			"pjt_nm_etc": [""],
			"pjt_mngr_kor": [""],
			"pjt_mngr_etc": [""],
			"dataset_cntrbtr_kor": [""],
			"dataset_cntrbtr_etc": [""],
			"dataset_pblshr": [""],
			"dataset_pric": [""],
			"rrno": [""],
			"ntisno": [""]
		}
	}
```

