Species
Free reference endpointGET
/v1/speciesBrowse or search the species catalog for pickers, validation, or reference views.
Try in playgroundParameters
Optional
string
Searches common/scientific names.
integer
Page size (1-100). Default: 50.
integer
Starting index. Default: 0.
Status codes
200Species list returned.
400Invalid query params.
401Invalid, missing, or revoked API key.
429Rate limit exceeded.
Examples
cURL
curl "https://api.animaldetect.com/v1/species?search=fox&limit=20&offset=0" -H "Authorization: Bearer $ANIMAL_DETECT_API_KEY"Python
import os
import requests
response = requests.get(
"https://api.animaldetect.com/v1/species?search=fox&limit=20&offset=0",
headers={
"Authorization": "Bearer " + os.environ["ANIMAL_DETECT_API_KEY"],
"User-Agent": "MyApp/1.0 (ops@example.com)",
},
)
response.raise_for_status()
data = response.json()Node.js / Express
const response = await fetch(
'https://api.animaldetect.com/v1/species?search=fox&limit=20&offset=0',
{
headers: {
Authorization: 'Bearer ' + process.env.ANIMAL_DETECT_API_KEY,
},
}
)
const data = await response.json()Example response
{
"species": [
{
"id": "3184697f-51ad-4608-9a28-9edb5500159c",
"common_name": "fox",
"scientific_name": "vulpes vulpes",
"taxonomy": {
"class": "mammalia",
"order": "carnivora",
"family": "canidae",
"genus": "vulpes",
"species": "vulpes"
}
}
],
"pagination": {
"total": 1,
"limit": 20,
"offset": 0,
"has_more": false
}
}