Species occurrences near a point (GBIF, distance-ranked) API

Live biodiversity occurrence records within a radius of a lat/lon, fetched from GBIF's 3-billion-record occurrence index, re-ranked by true haversine distance, with a kingdom mix and unique-species count. Answers 'what species have been recorded near here', 'biodiversity around this coordinate'.

Price$0.01per request

MethodPOST

Route/v1/science/gbif-occurrences

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache21600s public

sciencegbifbiodiversityspeciesoccurrencegeoecologywildlife

API URLhttps://x402.hexl.dev/v1/science/gbif-occurrences

Integration docs

Example request

{
  "latitude": 37.77,
  "longitude": -122.42,
  "radiusKm": 5,
  "limit": 5
}

Example response

{
  "query": {
    "latitude": 37.77,
    "longitude": -122.42,
    "radiusKm": 5
  },
  "totalOccurrencesInArea": 2275608,
  "returned": 5,
  "uniqueSpecies": 5,
  "kingdomMix": {
    "Fungi": 4,
    "Animalia": 1
  },
  "records": [
    {
      "gbifKey": 5938085847,
      "scientificName": "Leratiomyces percevalii (Berk. & Broome) Bridge & Spooner",
      "vernacularName": null,
      "kingdom": "Fungi",
      "class": "Agaricomycetes",
      "family": "Strophariaceae",
      "basisOfRecord": "HUMAN_OBSERVATION",
      "eventDate": "2026-01-03T11:13:42",
      "latitude": 37.768147,
      "longitude": -122.453616,
      "distanceKm": 3
    },
    {
      "gbifKey": 5938098490,
      "scientificName": "Armillaria mellea (Vahl) P.Kumm.",
      "vernacularName": null,
      "kingdom": "Fungi",
      "class": "Agaricomycetes",
      "family": "Physalacriaceae",
      "basisOfRecord": "HUMAN_OBSERVATION",
      "eventDate": "2026-01-01T14:38:51",
      "latitude": 37.784156,
      "longitude": -122.391332,
      "distanceKm": 3
    },
    {
      "gbifKey": 5938029520,
      "scientificName": "Amanita muscaria subsp. flavivolvata Singer",
      "vernacularName": null,
      "kingdom": "Fungi",
      "class": "Agaricomycetes",
      "family": "Amanitaceae",
      "basisOfRecord": "HUMAN_OBSERVATION",
      "eventDate": "2026-01-02T10:31:42",
      "latitude": 37.78687,
      "longitude": -122.449255,
      "distanceKm": 3.2
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "radiusKm": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 50,
      "default": 5
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}