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 Recorded By → Get

AI-generated

Overview

This node integrates with the Global Biodiversity Information Facility (GBIF) API to retrieve biodiversity data. Specifically, for the "Occurrence Search Recorded By" resource with the "Get" operation, it performs a search query to find occurrence records filtered by the person who recorded them. This is useful for researchers or organizations wanting to find biodiversity occurrence data associated with specific recorders.

Practical examples include:

  • Retrieving all occurrence records recorded by a particular scientist or observer.
  • Filtering occurrence data based on text queries related to the recorder's name.
  • Limiting the number of results returned for manageable data processing.

Properties

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

Output

The node outputs an array of JSON objects representing occurrence records that match the search criteria for the "recordedBy" field. Each object contains detailed information about individual occurrences as provided by the GBIF API.

No binary data output is produced by this node.

Dependencies

  • External Service: GBIF public API (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 no data is returned, verify the correctness and specificity of the Query parameter. Broad or misspelled queries may yield no matches.
  • Limit Exceeded: The limit property must be set and should not exceed 300. Setting a higher value may cause errors or truncated responses.
  • API Connectivity Issues: Network problems or GBIF API downtime will result in request failures. Check network connectivity and GBIF service status.
  • Invalid Parameter Errors: Ensure that the limit is a valid string representing a number and that q is a non-empty string if filtering is intended.

Links and References

Discussion