GBIF icon

GBIF

GBIF provides free and open access to biodiversity data

Actions22

  • Collection Actions
  • Dataset Actions
  • Dataset Search Actions
  • Installation Actions
  • Institution Actions
  • Occurrence Actions
  • Occurrence Count Actions
  • Occurrence Search Actions
  • Occurrence Search Catalog Number Actions
  • Occurrence Search Collection Code Actions
  • Occurrence Search Occurrence ID Actions
  • Occurrence Search Recorded By Actions
  • Occurrence Search Record Number Actions
  • Occurrence Search Institution Code Actions
  • Organization Actions
  • Name Parser Actions
  • Network Actions
  • Node Actions
  • Species Actions
  • Species Match Actions
  • Species Search Actions
  • Species Suggest Actions

Occurrence Count → Get

AI-generated

Overview

This node interacts with the GBIF (Global Biodiversity Information Facility) API to retrieve occurrence count data related to biodiversity records. Specifically, for the "Occurrence Count" resource with the "Get" operation, it fetches aggregated counts of occurrence records filtered by various criteria such as basis of record, country, dataset key, georeferenced status, taxon key, year, and more.

This node is beneficial in scenarios where users want to analyze biodiversity data quantitatively, for example:

  • Getting the number of fossil specimen occurrences recorded in a specific country.
  • Counting occurrences published by certain countries or datasets.
  • Filtering occurrence counts by year or type status to study temporal or taxonomic trends.

Practical examples include ecological research, conservation planning, or biodiversity informatics workflows where summary statistics about species occurrences are needed.

Properties

Name Meaning
Sub-Resource The dimension by which to aggregate occurrence counts. Options: (empty), Basis Of Record, Countries, Datasets, Publishing Countries, Year.
Additional Fields A collection of optional filters to refine the occurrence counts:
- Basis of Record: Filters by type of record (e.g., Fossil Specimen, Human Observation, Literature, etc.)
- Country: ISO 639-1 two-letter country code to filter by country.
- Dataset Key: Filter by dataset identifier.
- Is Georeferenced: Boolean to filter by whether occurrences have geographic coordinates.
- Issue: Multi-select filter for indexing issues affecting records (e.g., Accepted Name Missing, Homonym, Unparsable, etc.).
- Protocol: Filter by protocol/mechanism used to provide the occurrence record.
- Publishing Country: ISO 639-1 two-letter code to filter by publishing country.
- Taxon Key: Filter by taxonomic key.
- Type Status: Filter by nomenclatural type status (e.g., Holotype, Paratype, Lectotype, etc.).
- Year: Filter by year of occurrence.

Output

The node outputs an array of JSON objects representing the occurrence counts aggregated according to the selected sub-resource and filtered by the specified additional fields. The exact structure depends on the sub-resource chosen but generally includes count values and associated metadata (e.g., country codes, years, basis of record types).

No binary data output is produced by this node.

Dependencies

  • Requires internet access to call the public GBIF API at https://api.gbif.org/v1.
  • No authentication or API keys are required for this endpoint.
  • Uses standard HTTP GET requests with query parameters based on user input.

Troubleshooting

  • Empty or no results: Check that the filters applied (e.g., country codes, taxon keys, year) are valid and correspond to existing data in GBIF. Overly restrictive filters may yield no data.
  • Invalid country codes or taxon keys: Ensure ISO 639-1 country codes and taxon keys are correctly formatted.
  • API request failures: Network issues or GBIF API downtime can cause errors. Verify connectivity and retry later.
  • Incorrect sub-resource selection: Selecting an unsupported or empty sub-resource may result in unexpected output or errors.
  • Large result sets: Although this endpoint returns counts, complex queries might be slow; consider simplifying filters.

Links and References

This summary covers the "Occurrence Count" resource with the "Get" operation, detailing its input properties, output format, dependencies, and common troubleshooting tips based on static analysis of the provided source code and property definitions.

Discussion