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 Search Institution Code → Get

AI-generated

Overview

This node interacts with the GBIF (Global Biodiversity Information Facility) API to perform biodiversity data queries. Specifically, for the Occurrence Search Institution Code - Get operation, it performs a search for occurrence records filtered by institution codes and other optional parameters. This is useful for researchers or organizations wanting to retrieve biodiversity occurrence data associated with specific institutions.

Practical examples include:

  • Searching for all occurrence records linked to a particular institution code.
  • Filtering occurrences by additional criteria such as date ranges, geographic location, or taxonomic information.
  • Retrieving a limited number of results for quick data exploration.

Properties

Name Meaning
Query (q) A simple full-text search parameter; can be a word or phrase to filter occurrence records.
Limit (limit) The maximum number of results to return; required and capped at a maximum of 300.

These properties allow users to specify a text query and limit the number of returned occurrence records related to institution codes.

Output

The node outputs an array of JSON objects representing the occurrence records matching the search criteria. Each object corresponds to an occurrence record from GBIF's database, containing detailed biodiversity data fields such as taxonomy, location, date, and institution information.

No binary data output is produced by this node.

Dependencies

  • The node requires internet access to call the GBIF public API at https://api.gbif.org/v1.
  • No authentication or API keys are needed since GBIF provides free and open access.
  • The node uses standard HTTP GET requests with JSON responses.

Troubleshooting

  • Empty Results: If no data is returned, verify that the Query parameter is correctly specified and matches existing institution codes or relevant terms.
  • Limit Exceeded: The limit property must be set and should not exceed 300; otherwise, the API may reject the request.
  • Network Issues: Ensure network connectivity to api.gbif.org. Timeouts or connection errors will prevent data retrieval.
  • Invalid Parameters: Providing unsupported or malformed query strings may cause errors or empty responses. Validate input values carefully.

Links and References

This summary focuses on the "Occurrence Search Institution Code" resource with the "Get" operation, reflecting the node's behavior and configuration options based on static analysis of the provided source code and property definitions.

Discussion