Get started
Search organisms in Duaer
In Duaer, search UniProt taxonomy with Duaer Data. One successful search uses 1 credit. Use the scientific name with proteins/structures organism, and taxonId with taxonomyId. This page includes the full English call skill.
What you get
Organisms in Duaer data searches UniProt taxonomy. One successful search uses 1 credit.
Add the node from the Duaer Data category (Organisms). Use the scientific name with Proteins and Structures Organism; use taxonId with Taxonomy ID.
Search on the canvas
- Open the node creator, select Duaer Data, then Organisms.
- 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.
- 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 English call skill.
Call skill
The skill for calling this data. Keep it English.
---
name: duaer-organisms
description: >-
Duaer organisms. Search organism names. Use the scientific name with proteins.organism and structures.organism.
One successful search uses 1 Duaer credit.
---
# Duaer organisms
Search organism names. Use the scientific name with proteins.organism and structures.organism. Data comes from UniProt.
## When to use
- Get the scientific name or taxonomy id before searching proteins or structures.
- Look up the common name of a species.
## When not to use
- Full taxonomic classification. Use https://skills.duaer.com/ncbi-taxon.md.
## 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.
Get a Duaer key: https://skills.duaer.com/keys.md
## Parameters
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.
## Examples
- `GET https://api.duaer.com/v1/data/organisms?q=human&limit=10` — organisms matching human.
## Result
The response is `{ "items": [...] }`. Each item has `source` (`UniProt`), `title`, `url`, and `summary`, plus:
- `taxonId` — number.
- `scientificName`, `commonName`, `mnemonic`, `rank` — text.
Use `title` (scientific name) as `organism` when searching proteins or structures. Reuse `taxonId` as `taxonomyId` on proteins.
Fields without a value are empty strings.
## Credits
A successful search uses 1 credit, even when it finds nothing.
Wrong input or a missing search field returns 400 with a message and uses 0.
A failed upstream search returns 503 and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.
## Related
- https://skills.duaer.com/proteins.md — Duaer proteins
- https://skills.duaer.com/genes.md — Duaer genes
- https://skills.duaer.com/geo.md — Duaer GEO
- https://skills.duaer.com/cell-lines.md — Duaer cell lines
Questions
Where do I use an organism name from Duaer?
Put the item title (scientific name) into Proteins or Structures Organism, and taxonId into Taxonomy ID.
In this section
Search proteins in Duaer
In Duaer, search genes and proteins with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.
Get startedSearch protein structures in Duaer
In Duaer, search protein structures with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.
Get startedSearch diseases in Duaer
In Duaer, search UniProt disease names with Duaer Data. One successful search uses 1 credit. Use the formal name with proteins.disease. This page includes the full English call skill.
Get startedSearch clinical trials in Duaer
In Duaer, search clinical trials with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.