Duaer

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

  1. Open the node creator, select Duaer Data, then Proteins.
  2. 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.
  3. 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

Get started

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 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.

Get started

Search 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 started

Search 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 started

Search 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 started

Search 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 started

Search 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 started

Search 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 started

Search 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 started

Search 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 started

Search 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.