Search animals.
Searches the catalogue and answers one page of animals, ranked by iNaturalist observation count. q matches common names in all eight languages, the scientific name and category words; it is a prefix match, ignores diacritics and falls back to a substring match from three characters. Pass ids to read up to 500 known animals in one request; the answer is then a plain array.
Request
- Base URL: https://animalchecklist.com/api/v1
- URL: https://animalchecklist.com/api/v1/animals
- Auth: none required
Query parameters
Free text, for example red fox.
Comma separated animal ids, at most 500. q, category, habitat and country narrow the list. The answer is a plain array without pagination.
Limit to one category.
Limit to one habitat.
ISO 3166-1 alpha-2 code. Ranks by observations in that country.
Page number, from 1.
Page size, 1 to 120.
Display language of name, category labels and the summary. Falls back to en.
Display language. Default en.
Response
One page of animals. Cached 5 minutes.
Example response
{
"data": {
"items": [
{
"id": "red-fox",
"nameSci": "Vulpes vulpes"
}
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.