Search organisms in Duaer

What you get

Organisms in the Duaer data market searches UniProt taxonomy. One successful search uses 1 credit.

Add the node from the Duaer Data category (Organisms), or copy the skill on the data market. Use the scientific name with Proteins and Structures Organism; use taxonId with Taxonomy ID.

Search on the canvas

1. Open the node creator, select Duaer Data, then Organisms.
2. Words alone is enough (a new node starts with human). Taxonomy ID, Scientific name, and Common name are optional; Taxonomy ID comes from taxonId on a result.
3. Limit defaults to 10, max 20. Select Execute step.

A successful search uses 1 credit. Items include source, title, url, summary, plus taxonId, scientificName, commonName, mnemonic, and rank. Use title (scientific name) as organism on proteins or structures. Production deliverables land in the data pool.

Call the API

• GET https://api.duaer.com/v1/data/organisms?...
• Authorization: Bearer <Duaer key>
• Fields combine; at least one search field is required.

For keys, refer to Authentication for the Duaer public API. Below is the same English call skill as Copy skill.

Call skill

Same text as Copy skill on the Duaer data market. Keep it English.

---
name: duaer-organisms
description: >-
  Search organism names through Duaer. Use the scientific name with proteins.organism
  and structures.organism. One successful search uses 1 Duaer credit.
---

# Duaer organisms

Search UniProt taxonomy through Duaer with a Duaer key.

## Call

`GET https://api.duaer.com/v1/data/organisms?q=human&limit=10`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

At least one search field is required. Fields combine.
Search with `q` first; use `taxonId` only when you already have it from a result.

- `q` — words in the scientific or common name.
- `taxonId` — optional. NCBI / UniProt taxon id from a result (`taxonId`), such as `9606`.
- `scientific` — optional. Scientific name, such as `Homo sapiens`.
- `common` — optional. Common name, such as `human`.
- `limit` — optional. From 1 to 20. Default 10.

## Result

Each item has `source`, `title`, `url`, `summary`, `taxonId`, `scientificName`, `commonName`, `mnemonic`, and `rank`.
Use `title` (scientific name) as `organism` when searching proteins or structures. Reuse `taxonId` as `taxonomyId` on proteins.

## Credits

One successful search uses 1 credit.
An empty search, a failed search, a compound that matches nothing, or no remaining credits uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.