Go to menu Go to contents

Open API

About Open API

The open API of the Korean Natural History Research Information System (NARIS) enables individuals or organizations to freely use a search service for information on biological resources provided by the Korean Biodiversity Consortium in Korea, providing high-quality biodiversity information.

What is an Open API?
  • Open API is a Web2.0 technology that technically realizes the characteristics of the “web” as a platform. The programming interface that allows a website to make its functionality available to the public is called an Open API.
What is an authentication key?
  • You need an authentication key to use the Open API service of the Korean Natural History Research Information System.
  • If the authentication key is incorrect, you will be unable to use the service.
  • If you need to obtain a new authentication key due to an invalid or lost authentication key, please contact the administrator.
Service inquiries
  • Contact Info : +82-42-601-7724

How to use the Open API

XML and JSON-based linking data formats, update data request variables, and return code values are provided for using the standard Open API.

Common request variables

You can check the contents by dragging

Number, Request Variable, Value, Description for Common Request Variable Guide Table
No Request variables Values Description
1 apiKey String issue a Users Authenticated key
2 pageNo Integer Page Number of search results
Default : 1, Min : 1
3 recordCount Integer Print Number of one Page
Default : 10, Min : 1, Max : 50
Common Response Result

You can check the contents by dragging

Number, Request Variable, Value, Description for Common Request Variable Guide Table
No Request variables Values Description
1 rnum Integer Row number of search result
2 resultCode String Result code
3 resultMessage String Result message
Request URL

You can check the contents by dragging

요청 주소 내역을 보여줍니다.
Domain https://naris.science.go.kr
Extension .jsonView (JSON RESULTS)


You can check the contents by dragging

Specification of Rquest Address
No Address Description Specification
Search of Kingdom name(Taxonomy) Request Variables
Search of Kingdom name(Taxonomy) Request Variables정보
No Request variables Values Description
1 searchOfKngdmNm String search query of Kingdom name(Taxonomy)
Search of Kingdom name(Taxonomy) Response Elements
Search of Kingdom name(Taxonomy) Response Elements
No Response Variables Values Description
1 taxonKingdomSn Integer Sequence number of Kingdom
2 taxonKingdomNm String Kingdom name(Taxonomy)
Search of Phylum(or Division) Request Variables
Search of Phylum(or Division) Request Variables정보
No Request variables Values Description
1 idOfKingdom Integer search query of Kingdom id(Taxonomy)
2 searchOfKngdmNm String search query of Kingdom name(Taxonomy)
3 searchOfPhlmNm String search query of Phylum(or Division) name
Search of Phylum(or Division) Response Elements
Search of Phylum(or Division) Response Elements
No Response Variables Values Description
1 taxonKingdomSn Integer Sequence number of Kingdom
2 taxonKingdomNm String Kingdom name(Taxonomy)
3 taxonPhlmSn Integer Sequence number of Phylum(or Division)
4 taxonPhlmNm String Phylum(or Division) name
Search of species information Request Variables
Search of species information Request Variables정보
No Request variables Values Description
1 idOfSpecies Integer search query of species id
2 nameOfSpecies String search query of species name
3 idOfKingdom Integer search query of Kingdom id(Taxonomy)
4 idOfPhylum Integer search query of Phylum(or Division) id
5 protection String Protected plant or not
Search of species information Response Elements
Search of species information Response Elements
No Response Variables Values Description
1 speciesSerialNo Integer Sequence number of species information
2 taxonomyName String Taxonomy name
3 scientificName String Scientific name
4 scientificNameKor String Korean name
5 scientificNameEng String English name
6 authorOfScientificName String Author of a scientific name
7 genusLatin String Generic name(Latin name)
8 genusKor String Generic name(Korean)
9 subgenusLatin String Subgeneric name(Latin name)
10 subgenusKor String Subgeneric name(Korean)
11 specificEpithetLatin String Specific epithet(Latin name)
12 specificEpithetKor String Specific epithet(Korean)
13 specificEpithetAthrNm String Author of a scientific name about a specific epithet
14 specificEpithetMmngYr String Date that author of a specific epither designated
15 subspecisesSprtr String Data delimiter of subspecific epthet
16 subspecisesLatin String Subspecific epithet(Latin name)
17 subspecisesAthrNm String Author of a scientific name about a subspecific epithet
18 subspecisesMmngYr String Date that author of a subspecific epither designated
19 subspecisesKor String Subspecific epithet(Korean)
20 varietasSprtr String Data delimiter of variant species epthet
21 varietasLatin String Variant species epithet(Latin name)
22 varietasAthrNm String Author of a scientific name about a subspecific epithet
23 varietasMmngYr String Date that author of a variant species epither designated
24 varietasKor String Variant species epithet(Korean)
25 formaSprtr String Data delimiter of forma epthet
26 formaLatin String Forma epithet(Latin name)
27 formaAthrNm String Author of a scientific name about a forma epithet
28 formaMmngYr String Date that author of a scientific name designated
29 formaKor String Forma epithet(Korean)
30 endangeredKorDesc String Explanation about Endangered species(Korean)
31 endangeredEngDesc String Explanation about Endangered species(English)
32 naturalMonKor String Name designated as a natural monument(Korean)
33 naturalMonEng String Name designated as a natural monument(English)
34 protectPlantKor String Name as a protected plant
35 etcLangNm String Etc language name
36 ecologySpftrKor String Ecological characteristics(Korean)
37 ecologySpftrEng String Ecological characteristics(English)
38 generalSpftrKor String General characteristics(English)
39 generalSpftrEng String General characteristics(English)
40 sameAliasKor String Subjective synonym(Korean)
41 sameAliasEng String Subjective synonym(English)
42 northKorNm String Name used in North-Korea
43 generalNm String Common name
44 endangeredAt String Endangered species or not(Y or N)
45 naturalMonAt String Natural monument or not(Y or N)
46 protectPlant String Protected plant or not(Y or N)
47 imageOf3dLink String Link of 3D image
48 sampleCnt Integer Numbers of specimen data
49 observerCnt Integer Numbers of observational data
50 imageCnt Integer Numbers of image data
51 movieCnt Integer Numbers of video data
52 soundCnt Integer Numbers of sound data
53 dnaCnt Integer Numbers of DNA data
54 representationImage String Representation image
Search of species sound data Request Variables
Search of species sound data Request Variables정보
No Request variables Values Description
1 idOfSpecies Integer search query of species id
2 nameOfSpecies String search query of species name
3 idOfKingdom Integer search query of Kingdom id(Taxonomy)
4 idOfPhylum Integer search query of Phylum(or Division) id
5 protection String Protected plant or not
Search of species sound data Response Elements
Search of species sound data Response Elements
No Response Variables Values Description
1 speciesSerialNo Integer Sequence number of species information
2 taxonomyName String Taxonomy name
3 scientificName String Scientific name
4 scientificNameKor String Korean name
5 soundSubject String Title of sound
6 soundContent String Description of sound
7 soundRunningTime String Running time of sound
8 sndStreamUrl String Stream Service of sound
Search of species video data Request Variables
Search of species video data Request Variables정보
No Request variables Values Description
1 idOfSpecies Integer search query of species id
2 nameOfSpecies String search query of species name
3 idOfKingdom Integer search query of Kingdom id(Taxonomy)
4 idOfPhylum Integer search query of Phylum(or Division) id
5 protection String Protected plant or not
Search of species video data Response Elements
Search of species video data Response Elements
No Response Variables Values Description
1 speciesSerialNo Integer Sequence number of species information
2 taxonomyName String Taxonomy name
3 scientificName String Scientific name
4 scientificNameKor String Korean name
5 movSubject String Title of video
6 movContent String Description of video
7 movRunningTime String Running time of video
8 movRprsnImage String Representation image of video
9 movStreamUrl String Stream Service of video
Search of specimen data Request Variables
Search of specimen data Request Variables정보
No Request variables Values Description
1 idOfSample Integer search query of specimen id
2 idOfSpecies Integer search query of species id
3 nameOfSpecies String search query of species name
4 idOfKingdom Integer search query of Kingdom id(Taxonomy)
5 idOfPhylum Integer search query of Phylum(or Division) id
6 protection String Protected plant or not
7 agency String name of Agency in possession
Search of specimen data Response Elements
Search of specimen data Response Elements
No Response Variables Values Description
1 sampleSerialNo String Sequence number of specimen data
2 speciesSerialNo Integer Sequence number of species information
3 taxonomyName String Taxonomy name
4 scientificName String Scientific name
5 scientificNameKor String Korean name
6 institutionName String Name of institution
7 identifierName String Name of identifier
8 dateOfIdentification String Date of identification
9 continentsOrOcean String Continent or Ocean
10 countryName String Name of country
11 distinctionOfSex String Gender
12 age String Age
13 sampleManufacture String Manufacture form of specimen
14 preservationForm String Conserved form
15 beforeListNo String Old index numbers
16 originalAt String Original specimen hold or not
17 publicAt String Open to the public or not
18 provinceName String Location of Do
19 sigunguName String Name of Si/Gun/Gu(Address)
20 emndnName String Name of Eup/Myeon/Dong(Address)
21 collectorName String Name of collector
22 collectionDate String Date of collecting
23 timeOfCollection String Time of collection
24 businessName String Business name
25 countryOfOrigin String Country of origin
26 publicOrigin String Open to the public for place of orgin or not
27 resourcePublicAt String Open to the public for data or not
28 countryExportAt String Whether taken out to other country
29 parcelOutPassibleAt String Parcel specimen out can or not
30 manageNo String Number of management
31 synecologyNo String Number of synecoloy
32 areaOfStorage String Storage place
33 sourceOfSampleInfo String Source of specimen data
34 sampleHistory String Management history of specimen
35 sampleUsageDocument String Record about use of specimen
Search of observational data Request Variables
Search of observational data Request Variables정보
No Request variables Values Description
1 idOfObserve Integer search query of observational id
2 idOfSpecies Integer search query of species id
3 nameOfSpecies String search query of species name
4 idOfKingdom Integer search query of Kingdom id(Taxonomy)
5 idOfPhylum Integer search query of Phylum(or Division) id
6 protection String Protected plant or not
7 agency String name of Agency in possession
Search of observational data Response Elements
Search of observational data Response Elements
No Response Variables Values Description
1 observerInfoSeq String Sequence number of observational data
2 speciesSerialNo Integer Sequence number of species information
3 taxonomyName String Taxonomy name
4 scientificName String Scientific name
5 scientificNameKor String Korean name
6 institutionName String Name of institution
7 identifierName String Name of identifier
8 dateOfIdentification String Date of identification
9 continentsOrOcean String Continent or Ocean
10 countryName String Name of country
11 distinctionOfSex String Gender
12 age String Age
13 originalAt String Original specimen hold or not
14 publicAt String Open to the public or not
15 provinceName String Location of Do
16 sigunguName String Name of Si/Gun/Gu(Address)
17 emndnName String Name of Eup/Myeon/Dong(Address)
18 observerName String Name of Observer
19 observDate String Date of observation
20 businessName String Business name
21 countryOfOrigin String Country of origin
22 publicOrigin String Open to the public for place of orgin or not
23 resourcePublicAt String Open to the public for data or not
24 countryExportAt String Whether taken out to other country
25 parcelOutPassibleAt String Parcel specimen out can or not
26 observations Integer Numbers of individual of observation

Related organizations