> 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/genes.md).

# 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.
## What you get

Genes in the Duaer data market searches public gene records. One successful search uses 1 credit.

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

## Search on the canvas

1. Open the node creator, select Duaer Data, then Genes.
2. Words alone is enough (a new node starts with INS). Symbol, Gene ID, and Species are optional.
3. Limit defaults to 10, max 20. Select Execute step.

A successful search uses 1 credit. Use symbol as gene when searching proteins. Production deliverables land in the [data pool](/getting-started/data-pool.md).

## Call the API

- GET https://api.duaer.com/v1/data/genes?...
- 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-genes
description: >-
  Search genes through Duaer. Use the symbol with proteins.gene.
  One successful search uses 1 Duaer credit.
---

# Duaer genes

Search genes through Duaer with a Duaer key.

## Call

`GET https://api.duaer.com/v1/data/genes?q=INS&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` or `symbol` first; use `id` only when you already have an NCBI Gene id.

- `q` — words in the gene symbol, name, or summary.
- `symbol` — optional. Official gene symbol, such as `INS`.
- `id` — optional. NCBI Gene id from a result (`geneId`), such as `3630`.
- `species` — optional. Species for words/symbol search. Default `human`.
- `limit` — optional. From 1 to 20. Default 10.

## Result

Each item has `source`, `title`, `url`, `summary`, `geneId`, `symbol`, `name`, `aliases`, `ensemblId`, `taxId`, `mapLocation`, and `typeOfGene`.
Use `symbol` as `gene` when searching proteins. Reuse `geneId` in `id` for an exact lookup.

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

### Where do I use a gene from Duaer?

Put the item symbol into the Proteins Gene field in Duaer.

## Related

- [Search proteins in Duaer](https://doc.duaer.com/getting-started/proteins.md)
- [Search organisms in Duaer](https://doc.duaer.com/getting-started/organisms.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)