Loading...
Animal Detect logo

Country Species

Free endpoint
GET /api/v1/countries/{code}/species

Filters species library by country and supports pagination.

Try in Playground

Required Parameters

  • code (CCA3) Country code (e.g., USA).

Optional Parameters

  • limit (integer) Page size (1-100). Default: 50.
  • offset (integer) Starting index. Default: 0.

Status Codes

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

const data = await response.json()

Example Response

JSON
{
  "country": "USA",
  "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": 25,
    "offset": 0,
    "has_more": false
  }
}