Country biodiversity profile (GBIF faceted snapshot) API

A one-call biodiversity profile for a country: total GBIF records plus a labeled breakdown by biological kingdom (with shares) and by record basis (field observation vs preserved specimen), plus a derived observation-share metric. Answers 'how biodiverse is this country's record set', 'animal vs plant share', 'is the data observed or museum specimens'.

Price$0.01per request

MethodPOST

Route/v1/science/gbif-biodiversity

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

sciencegbifbiodiversitycountrykingdomecologyconservationfacets

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

Integration docs

Example request

{
  "country": "CR"
}

Example response

{
  "country": "CR",
  "totalRecords": 39489694,
  "kingdoms": [
    {
      "kingdom": "Animalia",
      "records": 37813642,
      "share": 95.8
    },
    {
      "kingdom": "Plantae",
      "records": 1351186,
      "share": 3.4
    },
    {
      "kingdom": "Fungi",
      "records": 133987,
      "share": 0.3
    },
    {
      "kingdom": "Chromista",
      "records": 24558,
      "share": 0.1
    },
    {
      "kingdom": "Bacteria",
      "records": 11508,
      "share": 0
    },
    {
      "kingdom": "Protozoa",
      "records": 7356,
      "share": 0
    },
    {
      "kingdom": "Viruses",
      "records": 828,
      "share": 0
    },
    {
      "kingdom": "Archaea",
      "records": 199,
      "share": 0
    },
    {
      "kingdom": "incertae sedis",
      "records": 159,
      "share": 0
    }
  ],
  "dominantKingdom": "Animalia",
  "basisOfRecord": [
    {
      "basisOfRecord": "HUMAN_OBSERVATION",
      "records": 26533457,
      "share": 67.2
    },
    {
      "basisOfRecord": "MATERIAL_SAMPLE",
      "records": 6958057,
      "share": 17.6
    },
    {
      "basisOfRecord": "PRESERVED_SPECIMEN",
      "records": 5684826,
      "share": 14.4
    },
    {
      "basisOfRecord": "MACHINE_OBSERVATION",
      "records": 238242,
      "share": 0.6
    },
    {
      "basisOfRecord": "OCCURRENCE",
      "records": 33401,
      "share": 0.1
    },
    {
      "basisOfRecord": "MATERIAL_CITATION",
      "records": 17535,
      "share": 0
    },
    {
      "basisOfRecord": "OBSERVATION",
      "records": 12518,
      "share": 0
    },
    {
      "basisOfRecord": "FOSSIL_SPECIMEN",
      "records": 8890,
      "share": 0
    },
    {
      "basisOfRecord": "LIVING_SPECIMEN",
      "records": 2768,
      "share": 0
    }
  ],
  "observationShare": 67.8
}

Input schema

{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code, e.g. CR",
      "pattern": "^[A-Za-z]{2}$"
    }
  }
}

Output schema

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