Amazing Endemic Species

How to Use This API

1. Get All Species

https://amazing-endemic-species-api.herokuapp.com/api/species

Returns a list of all endemic species in the database with their full details.

2. Filter by Region

https://amazing-endemic-species-api.herokuapp.com/api/species?region=Madagascar

Filter species endemic to a specific geographic region or country.

3. Filter by Conservation Status

https://amazing-endemic-species-api.herokuapp.com/api/species?conservation_status=CR

Use IUCN codes: CR (Critically Endangered), EN (Endangered), VU (Vulnerable), NT (Near Threatened), LC (Least Concern).

4. JavaScript — Species Explorer

async function getEndemicSpecies(filters = {}) {
  const params = new URLSearchParams(filters);
  const resp = await fetch(
    `https://amazing-endemic-species-api.herokuapp.com/api/species?${params}`
  );
  return await resp.json();
}

async function exploreMadagascar() {
  const species = await getEndemicSpecies({ region: 'Madagascar' });
  if (!species.length) return;
  
  const endangered = species.filter(s =>
    ['CR', 'EN'].includes(s.conservation_status)
  );
  
  console.log(`${species.length} endemic species in Madagascar`);
  console.log(`${endangered.length} of which are endangered/critically endangered`);
  endangered.slice(0, 5).forEach(s => {
    console.log(`  ${s.common_name} (${s.scientific_name}) — ${s.conservation_status}`);
  });
}

exploreMadagascar();

5. Python — Conservation Status Count

import requests

def status_breakdown():
    resp = requests.get(
        'https://amazing-endemic-species-api.herokuapp.com/api/species'
    )
    species = resp.json()
    
    status_counts = {}
    for s in species:
        status = s.get('conservation_status', 'Unknown')
        status_counts[status] = status_counts.get(status, 0) + 1
    
    print("Conservation status breakdown:")
    for status, count in sorted(status_counts.items()):
        print(f"  {status}: {count} species")

status_breakdown()