UnifyAPI
← Back to catalog

col.suggest

mock data$0.001 / call

Autocomplete Species Name in Catalogue of Life

Autocomplete a partial species or taxon name against the Catalogue of Life working draft, returning up to 25 ranked suggestions. Each suggestion includes the usage ID (for passing to col.species.detail or col.species.children), the matched name string, taxonomic rank, status (accepted/synonym), taxonomic group (e.g. "insects", "flowering plants", "birds"), higher-taxon context (e.g. "Hominidae"), and a human-readable suggestion string. Ideal for type-ahead name disambiguation in scientific workflows, species identification pipelines, or biodiversity data cleaning tasks. Optionally restrict suggestions to a specific rank (e.g. GENUS to return only genus-level matches).

Referenceprovider: Col#col#reference

Input schema

rank

Restrict suggestions to a specific taxonomic rank (e.g. SPECIES, GENUS, FAMILY). Omit to return suggestions across all ranks.

string
limit

Maximum number of autocomplete suggestions to return (1–25, default 10).

integer
queryrequired

Partial or full name prefix for autocomplete (e.g. "Homo", "Pinus syl", "Pan tr"). Returns ranked suggestions from the COL working draft.

string

Call via REST

curl -X POST https://unifyapi.pro/api/call/col.suggest \
  -H "Authorization: Bearer uak_live_..." \
  -H "Content-Type: application/json" \
  -d '{"rank":"<rank>","limit":0,"query":"<query>"}'

Try it

Paste a UnifyAPI key (create one in the dashboard) and run a real call.