GBIF biodiversiteit

Basisadres

https://api.gbif.org/v1

Endpoints 11

• GET/occurrence/searchWaarnemingen zoeken met filters; limit=0 geeft alleen het aantal, facet= telt per veld (jaar, soort, dataset, licentie …).
• GET/occurrence/{key}Eén waarneming met alle velden.
• GET/occurrence/count?country=NLAlleen het aantal, als kaal getal.
• GET/species/match?name={naam}Wetenschappelijke naam → taxonKey (Halyomorpha halys = 4485843), met rang, classificatie en zekerheid.
• GET/species/search?q={tekst}Soorten zoeken op (ook Nederlandse) naam, bv. q=merel.
• GET/species/{key}/vernacularNamesVolksnamen per taal (language nld = Nederlands): 4485843 → Bruingemarmerde schildwants.
• GET/dataset/searchDatasets zoeken: publishingCountry=NL gaf 400 datasets.
• GET/dataset/{key}Eén dataset: titel, uitgever, licentie, beschrijving, contact.
• GET/organization?country=NLUitgevende organisaties (70 in Nederland).
• GEThttps://api.gbif.org/v2/map/occurrence/density/{z}/{x}/{y}@1x.pngKaarttegels met de dichtheid van waarnemingen; dezelfde filters als zoeken (country=NL, taxonKey …).
• POST/occurrence/download/requestVolledige download (SIMPLE_CSV, DWCA, SPECIES_LIST) met een JSON-predicaat; asynchroon, met account. Geeft een download-key en een DOI om te citeren.

Filteren getest

Queryparameters per veld; herhaal een parameter voor OF, verschillende parameters zijn EN. Bereiken met een komma (year=1990,2025).

Parameters 10

Velden in het zoekantwoord (selectie) 12

Limieten en valkuilen

• Zoeken: hoogstens 300 records per verzoek en offset + limit ≤ 100.001; daarboven 400 'Max offset of 100001 exceeded'. Voor meer: facetten of een download. getest
• dataset/search pagineert diep heel traag (offset 123.000 = 186 s). Haal datasets liever per uitgevende organisatie op. ervaring
• Geen sleutel en geen gedocumenteerde aanvraaglimiet voor zoeken; robots.txt van api.gbif.org verbiedt alleen /v1/image/unsafe. getest
• Licentie per record. Van de NL-waarnemingen is 116,7 mln CC BY-NC 4.0 (niet-commercieel), 26,6 mln CC BY 4.0 en 7,0 mln CC0. De grootste dataset, Observation.org (waarneming.nl, 107,9 mln), is CC BY-NC. Tel met facet=license. getest
• 94% van de NL-records is een menselijke waarneming (HUMAN_OBSERVATION, 141,8 mln); museumstukken (PRESERVED_SPECIMEN) 2,3 mln. getest
• Filteren op soort gaat met taxonKey, niet op naam. Zoek de sleutel eerst met species/match en controleer matchType (EXACT) en confidence. getest
• Meer waarnemingen kan ook meer waarnemers betekenen: het aantal NL-records per jaar groeit (2022 10,9 mln, 2025 12,5 mln). Normaliseer, bv. per totaal aantal records in dat jaar. getest
• Voor Nederlandse soortnamen: species/{key}/vernacularNames met language nld. Voor sommige groepen (Magnoliopsida, Agaricomycetes) is er geen Nederlandse naam. ervaring
• POST /occurrence/download/request zonder inlog gaf een lege 404; downloads alleen met een account. Citeer de DOI van de download. getest

Probeer het HTTP 200 · 632 ms · 16 okt

https://api.gbif.org/v1/occurrence/search?country=NL&taxonKey=4485843&limit=0&facet=year&facetLimit=10

{
  "offset": 0,
  "limit": 0,
  "endOfRecords": false,
  "count": 17815,
  "results": [],
  "facets": [
    {
      "field": "YEAR",
      "counts": [
        {
          "name": "2025",
          "count": 6362
        },
        {
          "name": "2024",
          "count": 4657
        }
      ]
    }
  ]
}

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.