GET /search/1.0.json

eol.org:encyclopedia-of-life-api

Summary: Search for taxa by name
Operation ID: searchTaxa
Auth: none

Search the Encyclopedia of Life database for species by scientific or common name. This endpoint returns a paginated list of matching taxa with their EOL page IDs, scientific names, and links. It's the primary discovery endpoint for finding species when you don't know the exact EOL page ID. Results include up to 50 items per page and contain enough metadata to identify the correct species among similar matches.

Original spec description

Search for taxa using scientific or common names. Returns a list of matching EOL pages with identifiers and links.

Usage Tips

- Results are paginated (max 50 per page) - use the `page` parameter to navigate - For exact matches only, set `exact=true` to filter out partial matches - The `q` parameter accepts both scientific names (e.g., "Panthera tigris") and common names (e.g., "tiger") - Use `cache_ttl` to control how long results are cached in seconds - This endpoint is ideal for autocomplete or search-as-you-type functionality

Parameters (3)

cache_ttl (integer, query, optional)

Number of seconds to cache the response

page (integer, query, optional, default: 1)

Page number for paginated results (30 results per page)

Constraints: {'minimum': 1}

q (string, query, required)

The search query string (scientific or common name)

Examples (5)

TitleTypeURLAction
Search for species openapi-spec https://eol.org/api/search/1.0.json?q=Panthera tigris
Search for Marchantia with all pages doc_extracted https://api.eol.org/search/1.0.json?q=Marchantia&page=all
Search for Western Honeybee doc_extracted https://api.eol.org/search/1.0.json?q=Western%20Honeybee
Search for taxa by name openapi-spec https://eol.org/api/search/1.0.json?q=Panthera leo
Search for taxa by name probe-gate https://eol.org/api/search/1.0.json?q=Panthera+leo&page=1

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:34:47.088608 200 414ms
2026-03-23 09:48:40.873458 200 1830ms
2026-03-23 09:17:31.694984 500 455ms
2026-03-23 09:04:35.579114 500 390ms
2026-03-23 09:02:00.052811 200 470ms
2026-03-21T23:17:50.634731 200 352ms

Response Changes

WhenOldNew
2026-03-23 09:04:35.579114 87996b7a3df3 da0321d3386a
2026-03-23 09:48:40.873458 da0321d3386a 87996b7a3df3
2026-03-23 10:34:47.088608 87996b7a3df3 cb4d922ff0c6