Get started
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.
What you get
Proteins in Duaer data searches genes and proteins from a public protein source. One successful search uses 1 credit.
Add the node from the Duaer Data category (Proteins). For interaction partners, refer to Search interactions in Duaer.
Search on the canvas
- Open the node creator, select Duaer Data, then Proteins.
- Fill at least one of Words, Gene, Protein name, Organism, Accession, Reviewed, Length from/to, Disease, Keyword, Location, Function, Gene Ontology, Pathway, Domain, Taxonomy ID. For formal disease names, refer to Search diseases in Duaer. For organism names and Taxonomy ID, refer to Search organisms in Duaer. For keywords, locations, Gene Ontology, pathways, and domains, refer to Search keywords in Duaer, Search locations in Duaer, Search Gene Ontology in Duaer, Search pathways in Duaer, and Search domains in Duaer.
- Limit defaults to 10, max 20. Select Execute step.
A successful search uses 1 credit. Items include source, title, url, summary, plus accession, gene, organism, length, reviewed, disease, and location. Production deliverables land in the data pool.
Call the API
- GET https://api.duaer.com/v1/data/proteins?...
- 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-proteins
description: >-
Duaer proteins. UniProt proteins by gene, name, organism, accession, review status, length, disease, keyword, location, function, GO term, pathway, domain, or taxonomy id.
One successful search uses 1 Duaer credit.
---
# Duaer proteins
Duaer proteins searches UniProtKB. Fields combine, so each one narrows the search.
## When to use
- Get the reviewed human protein for a gene symbol.
- List proteins linked to a disease, a pathway, or a domain.
- Find proteins in a cell location with a given function.
## When not to use
- Gene ids, aliases, and map locations. Use https://skills.duaer.com/genes.md.
- Predicted 3D models. Use https://skills.duaer.com/alphafold.md.
- Experimental structures. Use https://skills.duaer.com/structures.md.
## Call
`GET https://api.duaer.com/v1/data/proteins?gene=INS&organism=Homo%20sapiens&reviewed=yes&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
Provide at least one search field.
- `q` — Optional. Words in the protein record.
- `gene` — Optional. Gene symbol, such as `INS`. Look up symbols with https://skills.duaer.com/genes.md.
- `name` — Optional. Protein name.
- `organism` — Optional. Organism name, such as `Homo sapiens`. Look up names with https://skills.duaer.com/organisms.md.
- `accession` — Optional. UniProt accession, such as `P01308`.
- `reviewed` — Optional. `yes` for Swiss-Prot, `no` for TrEMBL.
- `lengthFrom`, `lengthTo` — Optional. Sequence length. `0` means no bound.
- `disease` — Optional. Disease name. Look up names with https://skills.duaer.com/diseases.md.
- `keyword` — Optional. UniProt keyword. Look up keywords with https://skills.duaer.com/keywords.md.
- `location` — Optional. Subcellular location. Look up names with https://skills.duaer.com/locations.md.
- `function` — Optional. Words in the function text.
- `go` — Optional. Gene Ontology term. Look up terms with https://skills.duaer.com/gene-ontology.md.
- `pathway` — Optional. Reactome pathway id or words. Look up pathways with https://skills.duaer.com/pathways.md.
- `domain` — Optional. InterPro domain id or words. Look up domains with https://skills.duaer.com/domains.md.
- `taxonomyId` — Optional. NCBI taxonomy id, such as `9606`. Look up ids with https://skills.duaer.com/organisms.md.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.
## Examples
- `GET https://api.duaer.com/v1/data/proteins?gene=INS&organism=Homo%20sapiens&reviewed=yes` — reviewed human insulin.
- `GET https://api.duaer.com/v1/data/proteins?disease=Alzheimer%20disease&taxonomyId=9606&reviewed=yes` — reviewed human proteins linked to Alzheimer disease.
- `GET https://api.duaer.com/v1/data/proteins?accession=P04637` — one protein by accession.
## Result
The response is `{ "items": [...] }`. Each item has `source` (`UniProt`), `title`, `url`, and `summary`, plus:
- `accession` — UniProt accession.
- `gene` — primary gene symbol.
- `organism` — scientific name.
- `length` — sequence length.
- `reviewed` — true for Swiss-Prot entries.
- `disease`, `location` — linked diseases and subcellular locations.
For interaction partners of a gene or protein, use https://skills.duaer.com/interactions.md.
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/genes.md — Duaer genes
- https://skills.duaer.com/structures.md — Duaer structures
- https://skills.duaer.com/pathways.md — Duaer pathways
- https://skills.duaer.com/diseases.md — Duaer diseases
- https://skills.duaer.com/interactions.md — Duaer interactions
- https://skills.duaer.com/atlas.md — Duaer tissue atlas
- https://skills.duaer.com/alphafold.md — Duaer AlphaFold
- https://skills.duaer.com/complexes.md — Duaer complexes
Questions
How many credits does a Duaer protein search use?
One successful search uses 1 credit. Empty, failed, or no-credit searches use 0.
In this section
Search 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 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.
Get startedSearch keywords in Duaer
In Duaer, search UniProt keywords with Duaer Data. One successful search uses 1 credit. Use the formal name with proteins.keyword. This page includes the full English call skill.
Get startedSearch locations in Duaer
In Duaer, search UniProt subcellular locations with Duaer Data. One successful search uses 1 credit. Use the formal name with proteins.location. This page includes the full English call skill.
Get startedSearch Gene Ontology in Duaer
In Duaer, search Gene Ontology terms with Duaer Data. One successful search uses 1 credit. Use the name or goId with proteins.go. This page includes the full English call skill.
Get startedSearch pathways in Duaer
In Duaer, search Reactome pathways with Duaer Data. One successful search uses 1 credit. Use pathwayId with proteins.pathway. This page includes the full English call skill.
Get startedSearch genes in Duaer
In Duaer, search genes with Duaer Data. One successful search uses 1 credit. Use the symbol with proteins.gene. This page includes the full English call skill.
Get startedSearch interactions in Duaer
In Duaer, search STRING protein interaction partners with Duaer Data. One successful search uses 1 credit. 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.
Get startedSearch compounds in Duaer
In Duaer, search compounds and drugs with Duaer Data. One successful search uses 1 credit; a name that matches nothing uses 0. 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.