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 Collection Code → Get

AI-generated

Overview

This node integrates with the Global Biodiversity Information Facility (GBIF) API to retrieve biodiversity data. Specifically, for the Occurrence Search Collection Code resource with the Get operation, it performs a search query on occurrence records filtered by collection codes. This is useful for users who want to find biodiversity occurrence data associated with specific collection codes, such as museum or herbarium collections.

Typical use cases include:

  • Retrieving occurrence records linked to particular collection codes.
  • Filtering biodiversity data by collection identifiers for research or data analysis.
  • Accessing GBIF's rich dataset of species occurrences tied to physical or digital collections.

Example: A researcher wants to get all occurrence records from a specific collection code "ABC123" with a limit of 50 results.

Properties

Name Meaning
Query (q) A simple full-text search parameter; can be a word or phrase to filter occurrence records by collection code.
Limit (limit) The maximum number of results to return. Required. Maximum allowed is 300.

Output

The node outputs an array of JSON objects representing the occurrence records matching the collection code search criteria. Each object corresponds to an occurrence record returned by the GBIF API.

The output JSON structure directly reflects the GBIF API response for the /occurrence/search/collectionCode endpoint, including metadata and occurrence details.

No binary data output is produced by this node.

Dependencies

  • The node makes HTTP GET requests to the public GBIF API at https://api.gbif.org/v1.
  • No authentication or API keys are required for this endpoint.
  • Requires internet access from the n8n environment to reach the GBIF API.

Troubleshooting

  • Empty Results: If the query returns no data, verify that the q parameter is correctly specified and matches existing collection codes in GBIF.
  • Limit Errors: Ensure the limit parameter is set and does not exceed the maximum allowed (300).
  • Network Issues: Connection errors may occur if the n8n instance cannot reach the GBIF API endpoint.
  • API Changes: Since the node relies on the GBIF public API, any changes or downtime on their side may affect functionality.

Links and References

Discussion