GBIF Biodiversity
Search GBIF occurrence records — 2.8 billion+ observations of species worldwide
Custom Streaming + One-shot
Search GBIF occurrence records — 2.8 billion+ observations of species worldwide. Filter by taxon, location, date, and record type. Free, no API key needed. Returns species name, coordinates, date, country, and collection details.
Technical details
Authentication ▾
Contact us for setup details.
Ingestion ▾
Mode: Streaming + One-shot
Tools exposed (3) ▾
gbif/search_occurrences
Search GBIF occurrence records — 2.8 billion+ observations of species worldwide. Filter by taxon, location, date, and record type. Free, no API key needed. Returns species name, coordinates, date, country, and collection details.
gbif/search_species
Search the GBIF Backbone Taxonomy for species and higher taxa. Free, no API key needed. Covers 2.5M+ species. Returns scientific name, rank, status, kingdom, phylum, class, order, family, genus.
upsert_bento_get_gbif_occurrences
Create or update a recurring GBIF occurrence connector.
Inputs ▾
gbif/search_occurrences
| Name | Type | Required | Description |
|---|---|---|---|
| dashboardId | string | no | Target dashboard/initiative ID. Omit to use the current dashboard. |
| taxonKey | number | no | GBIF backbone taxonKey. Includes all child taxa and synonyms. Use gbif/search_species to find the key first. |
| scientificName | string | no | Scientific name to search for, e.g. 'Panthera leo'. |
| q | string | no | Free-text search across all occurrence fields. |
| country | string | no | ISO-3166-1 alpha-2 country code, e.g. 'US', 'GB', 'BR'. |
| continent | string | no | Filter by continent. AFRICA ANTARCTICA ASIA EUROPE NORTH_AMERICA OCEANIA SOUTH_AMERICA |
| basisOfRecord | string | no | Filter by record type. PRESERVED_SPECIMEN FOSSIL_SPECIMEN LIVING_SPECIMEN OBSERVATION HUMAN_OBSERVATION MACHINE_OBSERVATION MATERIAL_SAMPLE |
| eventDate | string | no | Date or date range in ISO 8601 format, e.g. '2020-01-01,2020-12-31'. |
| hasCoordinate | boolean | no | If true, only return georeferenced records. |
| decimalLatitude | string | no | Latitude range, e.g. '35,45' for between 35°N and 45°N. |
| decimalLongitude | string | no | Longitude range, e.g. '-10,10' for between 10°W and 10°E. |
| geometry | string | no | WKT POLYGON to search within, e.g. 'POLYGON((-10 35, 10 35, 10 45, -10 45, -10 35))'. |
| limit | number | no | Maximum number of records (max 300). Default 50. |
| offset | number | no | Pagination offset (max 100000). Default 0. |
| filter_paths | string[] | no | Optional glob paths to reduce the response. |
gbif/search_species
| Name | Type | Required | Description |
|---|---|---|---|
| dashboardId | string | no | Target dashboard/initiative ID. Omit to use the current dashboard. |
| q | string | yes | Free-text search query for species names, e.g. 'Passer domesticus', 'whale', 'orchid'. |
| rank | string | no | Filter by taxonomic rank. KINGDOM PHYLUM CLASS ORDER FAMILY GENUS SPECIES |
| highertaxonKey | number | no | Filter to species within a higher taxon (use a GBIF backbone taxonKey). |
| status | string | no | Filter by taxonomic status. ACCEPTED SYNONYM |
| habitat | string | no | Filter by habitat type. MARINE FRESHWATER TERRESTRIAL |
| limit | number | no | Maximum number of records to return (max 1000). Default 25. |
| offset | number | no | Pagination offset. Default 0. |
| filter_paths | string[] | no | Optional glob paths to reduce the response. |
upsert_bento_get_gbif_occurrences
| Name | Type | Required | Description |
|---|---|---|---|
| dashboardId | string | no | Target dashboard/initiative ID. Omit to use the current dashboard. |
| taxonKey | number | no | GBIF backbone taxonKey. Includes all child taxa and synonyms. Use gbif/search_species to find the key first. |
| scientificName | string | no | Scientific name to search for, e.g. 'Panthera leo'. |
| q | string | no | Free-text search across all occurrence fields. |
| country | string | no | ISO-3166-1 alpha-2 country code, e.g. 'US', 'GB', 'BR'. |
| continent | string | no | Filter by continent. AFRICA ANTARCTICA ASIA EUROPE NORTH_AMERICA OCEANIA SOUTH_AMERICA |
| basisOfRecord | string | no | Filter by record type. PRESERVED_SPECIMEN FOSSIL_SPECIMEN LIVING_SPECIMEN OBSERVATION HUMAN_OBSERVATION MACHINE_OBSERVATION MATERIAL_SAMPLE |
| eventDate | string | no | Date or date range in ISO 8601 format, e.g. '2020-01-01,2020-12-31'. |
| hasCoordinate | boolean | no | If true, only return georeferenced records. |
| decimalLatitude | string | no | Latitude range, e.g. '35,45' for between 35°N and 45°N. |
| decimalLongitude | string | no | Longitude range, e.g. '-10,10' for between 10°W and 10°E. |
| geometry | string | no | WKT POLYGON to search within, e.g. 'POLYGON((-10 35, 10 35, 10 45, -10 45, -10 35))'. |
| limit | number | no | Maximum number of records (max 300). Default 50. |
| offset | number | no | Pagination offset (max 100000). Default 0. |
| polling_frequency | string | yes | How often to poll GBIF for new occurrences. |
| connectorId | string | no | If provided, updates an existing connector. |
| description | string | no | Human-readable description shown in the connector UI. |