Catalog/data-inaturalist-species-counts

Science

Local biodiversity hotspot: top species by observation count API

Ranks the most-observed species within a radius of a lat/lon using iNaturalist's species_counts, returning each species' observation tally plus the total distinct-species count and an iconic-taxon mix. Answers 'what are the most common species here', 'the biodiversity of this area ranked by how often things are seen'.

Price$0.01per request
MethodPOST
Route/v1/science/inaturalist-species-counts
StatusLive
MIME typeapplication/json
Rate limit60/minute
Cache21600s public
scienceinaturalistspeciesbiodiversityrankingcitizen-sciencegeohotspot
API URLhttps://x402.hexl.dev/v1/science/inaturalist-species-counts
Integration docs
Example request
{
  "latitude": 37.77,
  "longitude": -122.42,
  "radiusKm": 10,
  "limit": 5
}
Example response
{
  "query": {
    "latitude": 37.77,
    "longitude": -122.42,
    "radiusKm": 10
  },
  "totalDistinctSpeciesInArea": 11905,
  "returned": 5,
  "observationsAcrossReturned": 27270,
  "mostObserved": {
    "scientificName": "Larus occidentalis",
    "commonName": "Western Gull",
    "rank": "species",
    "iconicTaxon": "Aves",
    "observationCount": 6462,
    "taxonId": 4345
  },
  "iconicTaxonMix": {
    "Aves": 4,
    "Plantae": 1
  },
  "species": [
    {
      "scientificName": "Larus occidentalis",
      "commonName": "Western Gull",
      "rank": "species",
      "iconicTaxon": "Aves",
      "observationCount": 6462,
      "taxonId": 4345
    },
    {
      "scientificName": "Calypte anna",
      "commonName": "Anna's Hummingbird",
      "rank": "species",
      "iconicTaxon": "Aves",
      "observationCount": 5507,
      "taxonId": 6317
    },
    {
      "scientificName": "Buteo jamaicensis",
      "commonName": "Red-tailed Hawk",
      "rank": "species",
      "iconicTaxon": "Aves",
      "observationCount": 5233,
      "taxonId": 5212
    },
    {
      "scientificName": "Ardea herodias",
      "commonName": "Great Blue Heron",
      "rank": "species",
      "iconicTaxon": "Aves",
      "observationCount": 5069,
      "taxonId": 4956
    },
    {
      "scientificName": "Eschscholzia californica",
      "commonName": "California poppy",
      "rank": "species",
      "iconicTaxon": "Plantae",
      "observationCount": 4999,
      "taxonId": 48225
    }
  ]
}
Input schema
{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    },
    "radiusKm": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}
Output schema
{
  "type": "object",
  "additionalProperties": true
}