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 Catalog Number → Get

AI-generated

Overview

This node integrates with the Global Biodiversity Information Facility (GBIF) API to retrieve biodiversity data. Specifically, for the Occurrence Search Catalog Number - Get operation, it performs a search query on occurrence records filtered by catalog numbers. This is useful for users who want to find biodiversity occurrence data based on catalog numbers assigned within physical collections or digital datasets.

Common scenarios include:

  • Retrieving occurrence records from biodiversity databases using catalog numbers.
  • Filtering and limiting results to manage large datasets.
  • Integrating GBIF occurrence data into workflows for ecological research, conservation projects, or biodiversity informatics.

Example: A researcher wants to fetch all occurrence records related to a specific catalog number keyword with a limit on the number of results returned.

Properties

Name Meaning
Query (q) A simple full-text search parameter; can be a word or phrase to filter occurrence catalog numbers.
Limit (limit) The maximum number of results to return; must be specified and has a maximum cap (e.g., 300).

Output

The output is a JSON array containing the search results from the GBIF API endpoint /occurrence/search/catalogNumber. Each item in the array represents an occurrence record matching the catalog number query.

  • The json field contains the parsed JSON response from the GBIF API.
  • The structure includes metadata about occurrences such as catalog numbers, institution codes, collection codes, and other relevant biodiversity occurrence details.
  • 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 key is required since GBIF provides free and open access.
  • Uses n8n's built-in HTTP request helper to perform GET requests.

Troubleshooting

  • Empty Results: If the query returns no results, verify that the q parameter is correctly set and matches existing catalog numbers.
  • Limit Exceeded: The API enforces a maximum limit (usually 300). Setting a higher limit may cause errors or truncated results.
  • Network Issues: Ensure the node has network connectivity to api.gbif.org.
  • Invalid Parameters: Passing unsupported or malformed parameters may result in API errors. Double-check input values.
  • API Changes: Since this relies on an external API, changes in GBIF endpoints or parameters could break functionality.

Links and References

This summary focuses exclusively on the "Occurrence Search Catalog Number" resource with the "Get" operation as requested.

Discussion