search: Search name usages with full-text search

API: catalogueoflife.org:catalogue-of-life-api
Endpoint: /dataset/{datasetKey}/nameusage/search
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 270ms

Description

Performs a full-text search across name usages in the dataset, returning results with classification information. This is the primary search endpoint for finding taxa.

Parameters (4)

datasetKey (string, path, required)

Dataset identifier

limit (integer, query, optional, default: 10)

Maximum number of results to return

offset (integer, query, optional, default: 0)

Number of results to skip

q (string, query, required)

Search query for scientific name (e.g., 'Panthera leo', 'Acer')

Examples (1)

Search name usages with full-text search openapi-spec
curl 'https://api.catalogueoflife.org/dataset/3LR/nameusage/search?q=Panthera+leo'
import requests

resp = requests.get(
    "https://api.catalogueoflife.org/dataset/3LR/nameusage/search",
    params={
        'q': 'Panthera leo',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("catalogueoflife")
result = api.fetch("dataset/{datasetKey}/nameusage/search", q="Panthera leo")

for item in result:
    print(item)
const resp = await fetch("https://api.catalogueoflife.org/dataset/3LR/nameusage/search?q=Panthera+leo");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 03:27:38.853909 200 270ms
2026-04-15 04:02:54.988336 200 216ms
2026-04-14 00:51:44.971511 200 281ms
2026-04-12 13:55:57.840678 200 360ms
2026-04-10 01:46:51.970739 200 163ms
2026-04-09 03:42:00.029748 200 379ms
2026-04-08 00:55:03.243636 200 342ms
2026-04-07 01:15:37.134454 200 178ms
2026-04-06 04:44:13.889819 200 248ms
2026-04-05 02:33:05.569611 200 175ms
2026-04-04 03:18:52.822130 200 233ms
2026-04-03 13:19:10.362322 200 330ms
2026-03-30 12:00:11.239250 ERR