earth

Search species occurrence records

Find where and when a species has been recorded, from GBIF. Resolves a scientific or common name to a taxon, then returns the total record count and georeferenced occurrence records (coordinates, date, country, dataset, licence). Only CC0 and CC BY records are returned.

Discipline pack: earth. Cost: 2 credits per successful call.

post/api/v1/search_species_occurrence

Request

  • Base URL: https://scholarmuse.ai
  • URL: https://scholarmuse.ai/api/v1/search_species_occurrence
  • Auth: HTTP bearer

Request body

speciesstring required

Scientific name (Danaus plexippus) or common name (monarch butterfly).

countrystring

Two-letter ISO 3166 country code, e.g. MX.

year_frominteger

Earliest year of the record.

year_tointeger

Latest year of the record.

has_coordinatesboolean

Only records with coordinates (default true).

limitinteger

Records to return (default 50).

Response

The tool result.

summarystring required
partialboolean
extraobject
credits_usednumber required
call_idstring required

Example response

{
  "billing": {
    "lowBalanceThreshold": 20
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.