Loading...
Animal Detect logo

Species

Free endpoint
GET /api/v1/species

Returns species records from the SpeciesNet library with optional name search.

Try in Playground

Optional Parameters

  • search (string) Searches common/scientific names.
  • limit (integer) Page size (1-100). Default: 50.
  • offset (integer) Starting index. Default: 0.

Status Codes

200Species list returned.
400Invalid query params.
401Invalid, missing, or revoked API key.
429Rate limit exceeded.
Node.js / Express
const response = await fetch(
  'https://www.animaldetect.com/api/v1/species?search=fox&limit=20&offset=0',
  {
    headers: {
      Authorization: 'Bearer ' + process.env.ANIMAL_DETECT_API_KEY,
    },
  }
)

const data = await response.json()

Example Response

JSON
{
  "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
  }
}