This API contains data on over 8000 critically endangered wild animals and plants. Data returned will contain details on taxonomy, population, location, and various other categories. All data was extracted from the IUCN Red List of Threatened Species.**
There are currently 6 unique endpoints you can query. Each will return either an object, an array of objects, or an error message.
To query by common name, simply use the “/common” route followed by the common name of the species.
/common/chinese-alligator
This will return a single object with information on the species queried. The parameter is not case-sensitive.
To query by scientific name, simply use the “/scientific” route followed by the scientific name of the species.
/common/alligator-sinensis
This will return a single object with information on the species queried. The parameter is not case-sensitive.
To query by taxonomy data, simply use the “/taxonomy” route followed by the taxonomy category and species taxonomy type.
An example would be trying to find all reptiles. The search would look as follows where class is the category and reptilia is the specific type being searched for.
/taxonomy/class?q=reptilia
This will return an array of objects with information on the species queried. The parameter is not case-sensitive. This parameter defaults to “mammalia”.
To query by population quantity, simply use the “/population” route followed by the number desired.
An example would be trying to find all species with a population of 1. Both of the following queries return the same results.
/population/1
/population/1?type=equal
The following query types are accepted:
This will return an array of objects with information on the species queried. The parameter is not case-sensitive. This parameter defaults to “equal”.
To query by population trend, simply use the “/population-trend” route followed by the desired trend.
An example would be trying to find all species with a decreasing population.
/population-trend/decreasing
The following query types are accepted:
This will return an array of objects with information on the species queried. The parameter is not case-sensitive.
To query by year assessed, simply use the “/assessed” route followed by the year desired.
/population/2021
/population/2021?type=equal
The following query types are accepted:
This will return an array of objects with information on the species queried. The parameter is not case-sensitive. This parameter defaults to “equal”.