Science

Data source: GBIF (Global Biodiversity Information Facility)

REST Bridge Endpoint https://context.gnist.ai/rest/gbif/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (6)

search_species
get_species
search_occurrences
search_datasets
get_species_distribution
report_feedback

search_species

Search the GBIF taxonomy backbone for species, genera, families, or higher taxa.

Covers 2.4M+ species from the GBIF backbone taxonomy — the most comprehensive
global species catalogue. Returns scientific names, common names, taxonomic hierarchy,
and occurrence counts. Data aggregated from 2,100+ institutions worldwide.

Args:
query: Species name or keyword to search.
rank: Taxonomic rank filter.
habitat: Habitat filter.
limit: Number of results (1–50, default 20).

Returns:
List of matching taxa with scientific name, common name, classification, and
occurrence count. Use the key with get_species or search_occurrences for details.

Parameter	Type	Required	Description
`query`	`string`	required	Species name or keyword (e.g. "Panthera leo", "orchid", "Atlantic salmon", "pine").
`rank`	`any`	optional	Taxonomic rank filter: SPECIES, GENUS, FAMILY, ORDER, CLASS, PHYLUM, KINGDOM. Omit for all.
`habitat`	`any`	optional	Habitat filter: MARINE, FRESHWATER, TERRESTRIAL. Omit for all.
`limit`	`integer`	optional	Number of results (1–50, default 20). (default: 20)

Request Body

{
  "query": "example"
}

get_species

Get full taxonomic details for a species by its GBIF taxon key.

Returns the complete classification hierarchy from kingdom to species,
plus status and occurrence count.

Args:
taxon_key: GBIF taxon key (numeric).

Returns:
Full taxonomic record. Returns found=false if key not found.

Parameter	Type	Required	Description
`taxon_key`	`string`	required	GBIF taxon key (numeric). Found in search_species results.

Request Body

{
  "taxon_key": "example"
}

search_occurrences

Search 2.4B+ biodiversity occurrence records — species sightings, specimens, and observations.

Each record is a documented observation of a species at a specific place and time.
Sources include museum specimens, citizen science (eBird, iNaturalist), research surveys,
and automated monitoring. Covers all of life — animals, plants, fungi, bacteria.

Args:
taxon_key: GBIF taxon key. Use search_species to find it.
scientific_name: Scientific name as alternative to taxon_key.
country: ISO country code to filter by location.
year_range: Year or year range filter.
basis_of_record: Filter by observation type.
has_coordinate: Only records with GPS coordinates.
limit: Number of results (1–50, default 20).

Returns:
List of occurrence records with species, location, date, observer, and source dataset.

Parameter	Type	Required	Description
`taxon_key`	`any`	optional	GBIF taxon key (numeric). Use search_species to find keys. Provide this or scientific_name.
`scientific_name`	`any`	optional	Scientific name (e.g. "Panthera leo"). Alternative to taxon_key.
`country`	`any`	optional	ISO 3166-1 alpha-2 country code (e.g. 'NO' for Norway, 'US', 'GB').
`year_range`	`any`	optional	Year or year range (e.g. '2023' or '2020,2024' for a range).
`basis_of_record`	`any`	optional	Record type: HUMAN_OBSERVATION, PRESERVED_SPECIMEN, MACHINE_OBSERVATION, FOSSIL_SPECIMEN, LIVING_SPECIMEN.
`has_coordinate`	`any`	optional	Filter to records with GPS coordinates.
`limit`	`integer`	optional	Number of results (1–50, default 20). (default: 20)

Request Body

{
  "query": "example"
}

search_datasets

Search 100K+ biodiversity datasets published through GBIF.

Datasets are collections of occurrence records or species checklists published by
institutions, museums, citizen science platforms, and research projects.

Args:
query: Search term for dataset titles and descriptions.
type_filter: Filter by dataset type.
publishing_country: Filter by country of the publishing organization.
limit: Number of results (1–50, default 20).

Returns:
List of datasets with title, description, type, publisher, and record count.

Parameter	Type	Required	Description
`query`	`string`	required	Dataset search term (e.g. "birds Norway", "marine mammals", "eBird", "herbarium").
`type_filter`	`any`	optional	Dataset type: OCCURRENCE, CHECKLIST, SAMPLING_EVENT, METADATA.
`publishing_country`	`any`	optional	ISO 3166-1 alpha-2 code of the publishing country.
`limit`	`integer`	optional	Number of results (1–50, default 20). (default: 20)

Request Body

{
  "query": "example"
}

get_species_distribution

Get the global distribution of a species — occurrence counts by country.

Shows which countries a species has been observed in and how many records exist.
Useful for understanding species range, conservation status, and biodiversity hotspots.

Args:
taxon_key: GBIF taxon key (numeric).

Returns:
List of countries with occurrence counts, sorted by count (highest first).

Parameter	Type	Required	Description
`taxon_key`	`string`	required	GBIF taxon key (numeric). Use search_species to find it.

Request Body

{
  "taxon_key": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/gbif/search_species" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"query": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/gbif/search_species",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())