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 longitudeCoordinates Integer Longitude coordinates
12 latitudeCoordinates Integer Latitude coordinates
13 distinctionOfSex String Gender
14 age String Age
15 sampleManufacture String Manufacture form of specimen
16 preservationForm String Conserved form
17 beforeListNo String Old index numbers
18 databaseNo String Database number
19 originalAt String Original specimen hold or not
20 publicAt String Open to the public or not
21 provinceName String Location of Do
22 sigunguName String Name of Si/Gun/Gu(Address)
23 emndnName String Name of Eup/Myeon/Dong(Address)
24 positionOfCollection String Detail location of collection
25 collectorName String Name of collector
26 collectionDate String Date of collecting
27 timeOfCollection String Time of collection
28 businessName String Business name
29 countryOfOrigin String Country of origin
30 publicOrigin String Open to the public for place of orgin or not
31 resourcePublicAt String Open to the public for data or not
32 countryExportAt String Whether taken out to other country
33 parcelOutPassibleAt String Parcel specimen out can or not
34 manageNo String Number of management
35 synecologyNo String Number of synecoloy
36 areaOfStorage String Storage place
37 sourceOfSampleInfo String Source of specimen data
38 sampleHistory String Management history of specimen
39 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 longitudeCoordinates Integer Longitude coordinates
12 latitudeCoordinates Integer Latitude coordinates
13 distinctionOfSex String Gender
14 age String Age
15 beforeListNo String Old index numbers
16 databaseNo String Database number
17 originalAt String Original specimen hold or not
18 publicAt String Open to the public or not
19 provinceName String Location of Do
20 sigunguName String Name of Si/Gun/Gu(Address)
21 emndnName String Name of Eup/Myeon/Dong(Address)
22 positionOfObserve String Detail location of observation
23 observerName String Name of Observer
24 observDate String Date of observation
25 businessName String Business name
26 countryOfOrigin String Country of origin
27 publicOrigin String Open to the public for place of orgin or not
28 resourcePublicAt String Open to the public for data or not
29 countryExportAt String Whether taken out to other country
30 parcelOutPassibleAt String Parcel specimen out can or not
31 observations Integer Numbers of individual of observation