GBIF Species API

Name: GBIF Species API
Brand: GBIF Species API
Availability: InStock

✓ Official Vendor SpecData EnrichmentData Transformationnone32 EndpointsREST

For Agents

Look up biological species by name, browse taxonomic trees, and enrich records with distributions, vernacular names, and IUCN red-list categories.

Install Jentic One Beta

Connect the GBIF Species API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GBIF Species API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with GBIF Species API.

Match a free-text scientific name to a canonical GBIF usage key with /v1/species/match

Search the species index with full-text queries via /v1/species/search

Suggest species names from a partial input through /v1/species/suggest for autocomplete UIs

GET STARTED

Start building with GBIF Species API

Explore with Jentic

View OpenAPI Document

The GBIF Species API exposes the Global Biodiversity Information Facility's checklist bank — a federated catalogue of taxonomic names, classifications, distributions, descriptions, and IUCN red list categories drawn from hundreds of contributing institutions. The API supports full-text search, name suggestion, name parsing, and traversal of the taxonomic tree from kingdom down to species and synonym, alongside per-species references, vernacular names, and media. It is the canonical machine-readable backbone for biodiversity research, ecology dashboards, and citizen-science apps. All 32 endpoints are open and require no authentication.

Use Cases

Patterns agents use GBIF Species API for, with concrete tasks.

★ Species Autocomplete For Citizen-Science Apps

Power a search box where users type the start of a species name and pick from suggestions. The agent calls /v1/species/suggest with the typed prefix and returns a ranked list of canonical names with their usage keys. Improves data quality at submission time by eliminating spelling variants.

GET /v1/species/suggest?q=helian&limit=10 and return the list of names with their usageKeys for display in a dropdown

Conservation Status Enrichment

Enrich a list of species observations with their IUCN red list category so an analyst can flag threatened species. The agent matches each name to a usage key with /v1/species/match, then calls /v1/species/{usageKey}/iucnRedListCategory. Removes manual cross-referencing against the IUCN site.

For each name, GET /v1/species/match?name={n} to get a usageKey, then GET /v1/species/{usageKey}/iucnRedListCategory and append the category to the row

Taxonomic Tree Visualisation

Render an interactive taxonomy browser from kingdom down to species. The agent calls /v1/species/{usageKey}/parents to walk upward and /v1/species/{usageKey}/children to expand nodes lazily. Supports museum exhibits, education sites, and field-guide apps.

GET /v1/species/{usageKey}/parents to build the breadcrumb, then GET /v1/species/{usageKey}/children to populate the next level when a node is expanded

Agent-Driven Biodiversity Research Through Jentic

AI research agents discover the GBIF Species API through Jentic, load the species match operation, and enrich species lists in field reports without bespoke client code. Brings authoritative taxonomy into research workflows that previously relied on training-data fragments. No credential is needed.

Use Jentic search query 'match a species name' to load the gbif_match_species tool, execute with name='Panthera leo', and return the canonical usageKey and scientificName

Key Endpoints

32 endpoints — the gbif species api exposes the global biodiversity information facility's checklist bank — a federated catalogue of taxonomic names, classifications, distributions, descriptions, and iucn red list categories drawn from hundreds of contributing institutions.

METHOD

PATH

DESCRIPTION

GET

/v1/species/match

Match a name string to a canonical species usage key

GET

/v1/species/search

Full-text search the species index

GET

/v1/species/suggest

Autocomplete species names from a prefix

GET

/v1/species/{usageKey}

Retrieve a species record by usage key

GET

/v1/species/{usageKey}/iucnRedListCategory

Get IUCN red list category for a species

GET

/v1/species/{usageKey}/parents

Walk the parent taxa of a species

GET

/v1/parser/name

Parse a scientific name string into structured parts

GET

/v1/species/match

Match a name string to a canonical species usage key

GET

/v1/species/search

Full-text search the species index

GET

/v1/species/suggest

Autocomplete species names from a prefix

GET

/v1/species/{usageKey}

Retrieve a species record by usage key

GET

/v1/species/{usageKey}/iucnRedListCategory

Get IUCN red list category for a species

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

GBIF requires no credentials, so Jentic simply executes the calls and returns structured responses. There is no vault entry to manage for this API.

Intent-based discovery

Agents search by intent (e.g. 'match a species name') and Jentic returns the right GBIF operation among the 32 endpoints, with input schema, so the agent does not have to disambiguate match vs search vs suggest by hand.

Time to first call

Direct GBIF integration: half a day to pick the right endpoint per use case and parse responses. Through Jentic: under 15 minutes — search, load schema, execute.

FAQs

Specific to using GBIF Species API through Jentic.

What authentication does the GBIF Species API use?

None. All 32 endpoints under /v1/species, /v1/parser, and related routes are public reads and require no API key or token. Jentic still routes through its execution layer for consistent error handling.

Can I match a free-text species name to a canonical record?

Yes. GET /v1/species/match accepts a name query parameter and returns the matched usage key plus confidence indicators, which you then use as the path parameter for any /v1/species/{usageKey}/* enrichment route.

What are the rate limits for the GBIF Species API?

GBIF does not publish hard rate-limit headers in the OpenAPI spec but asks heavy clients to throttle and identify themselves via a User-Agent. Back off on HTTP 429 and avoid tight loops across the 32 endpoints.

How do I get the IUCN red list category for a species?

First call GET /v1/species/match?name={name} to resolve the usageKey, then call GET /v1/species/{usageKey}/iucnRedListCategory to retrieve the conservation status if GBIF holds one for that taxon.

Can I parse a scientific name string with the GBIF API?

Yes. GET /v1/parser/name accepts a raw name string and returns structured components such as genus, species, infraspecific epithet, and authorship, useful for cleaning user-supplied input before a match call.

How do I look up a species through Jentic?

Install with pip install jentic, search 'match a species name', load the schema for the gbif_match_species operation, and execute with the scientific name. Because GBIF is keyless, no vault setup is required.