> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/getting-started/proteins.md).

# 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 the Duaer data market searches genes and proteins from a public protein source. One successful search uses 1 credit.

Add the node from the [Duaer Data category](/getting-started/duaer-data.md) (Proteins), or copy the skill on the [data market](/getting-started/data-market.md).

## 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, Taxonomy ID. For formal disease names, refer to [Search diseases in Duaer](/getting-started/diseases.md). For organism names, refer to [Search organisms in Duaer](/getting-started/organisms.md). For keywords, locations, Gene Ontology, and pathways, refer to [Search keywords in Duaer](/getting-started/keywords.md), [Search locations in Duaer](/getting-started/locations.md), [Search Gene Ontology in Duaer](/getting-started/gene-ontology.md), and [Search pathways in Duaer](/getting-started/pathways.md).
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](/getting-started/data-pool.md).

## 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](/api/authentication.md). 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-proteins
description: >-
  Search genes and proteins through Duaer. One successful search uses 1 Duaer credit.
---

# Duaer proteins

Search genes and proteins through Duaer with a Duaer key.

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

At least one search field is required. Fields combine.

- `q` — words in the protein record.
- `gene` — gene symbol.
- `name` — protein name.
- `organism` — organism name. Look up formal names with https://skills.duaer.com/organisms.md.
- `accession` — accession.
- `reviewed` — `yes` or `no`.
- `lengthFrom`, `lengthTo` — sequence length. `0` means no bound.
- `disease` — disease name. Look up formal names with https://skills.duaer.com/diseases.md.
- `keyword` — UniProt keyword. Look up formal names with https://skills.duaer.com/keywords.md.
- `location` — subcellular location. Look up formal names with https://skills.duaer.com/locations.md.
- `function` — words in the function text.
- `go` — Gene Ontology term. Look up terms with https://skills.duaer.com/gene-ontology.md.
- `pathway` — Reactome pathway id or words. Look up pathways with https://skills.duaer.com/pathways.md.
- `taxonomyId` — NCBI taxonomy id. Look up ids with https://skills.duaer.com/organisms.md.
- `limit` — optional. From 1 to 20. Default 10.

## Result

Each item has `source`, `title`, `url`, `summary`, `accession`, `gene`, `organism`, `length`, `reviewed`, `disease`, and `location`.

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

```
## Questions

### How many credits does a Duaer protein search use?

One successful search uses 1 credit. Empty, failed, or no-credit searches use 0.

## Related

- [Search diseases in Duaer](https://doc.duaer.com/getting-started/diseases.md)
- [Search organisms in Duaer](https://doc.duaer.com/getting-started/organisms.md)
- [Search keywords in Duaer](https://doc.duaer.com/getting-started/keywords.md)
- [Search locations in Duaer](https://doc.duaer.com/getting-started/locations.md)
- [Search Gene Ontology in Duaer](https://doc.duaer.com/getting-started/gene-ontology.md)
- [Search pathways in Duaer](https://doc.duaer.com/getting-started/pathways.md)
- [Search clinical trials in Duaer](https://doc.duaer.com/getting-started/trials.md)
- [Search compounds in Duaer](https://doc.duaer.com/getting-started/compounds.md)
- [Search protein structures in Duaer](https://doc.duaer.com/getting-started/structures.md)