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 Record 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 Record Number resource with the Get operation, it performs a search query on occurrence records filtered by their record number. This allows users to find occurrence records in GBIF's vast biodiversity database using a simple full-text search combined with additional filtering options.

Common scenarios where this node is beneficial include:

  • Researchers looking up specific occurrence records by their record numbers.
  • Biodiversity data analysts filtering occurrence data based on record identifiers.
  • Environmental scientists integrating occurrence data into workflows for ecological studies.

Example: You want to find all occurrence records that match a particular record number or phrase and limit the number of results returned.

Properties

Name Meaning
Query (q) A simple full text search parameter; can be a word or phrase to search occurrence records by record number.
Additional Fields (limit) The maximum number of results to return. This is required and limits the size of the response (maximum 300).

Output

The output is a JSON array containing the search results from the GBIF API endpoint /occurrence/search/recordNumber. Each item in the array represents an occurrence record matching the query parameters. The structure corresponds directly to the GBIF API response for occurrence searches by record number, including metadata about each occurrence such as taxonomic details, location, date, and other relevant fields.

No binary data is output by this node.

Dependencies

  • External Service: GBIF public API (https://api.gbif.org/v1)
  • No authentication or API keys are required for this endpoint.
  • The node uses HTTP GET requests to fetch data from GBIF.

Troubleshooting

  • Empty Results: If no data is returned, verify that the Query parameter (q) is correctly specified and matches existing record numbers.
  • Limit Exceeded: The limit property must be set and should not exceed 300; otherwise, the API may reject the request or truncate results.
  • Network Issues: Ensure that the n8n instance has internet access to reach the GBIF API.
  • Invalid Parameters: Providing unsupported or malformed query strings may result in errors or empty responses.

Links and References

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

Discussion