Duaer

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.

What you get

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

Add the node from the Duaer Data category (Genes). Use the symbol with Proteins 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.

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. Below is the English call skill.

Call skill

The skill for calling this data. Keep it English.

---
name: duaer-genes
description: >-
  Duaer genes. MyGene.info genes by words, official symbol, or NCBI Gene id, with name, aliases, Ensembl id, species, and map location.
  One successful search uses 1 Duaer credit.
---

# Duaer genes

Duaer genes searches MyGene.info for genes. It uses one search field: `id` first, then `symbol`, then `q`.

## When to use

- Turn a gene symbol or name into an NCBI Gene id and Ensembl id.
- Check aliases and the chromosome location of a gene.
- Get the official symbol before searching proteins or variants.

## When not to use

- Protein function, disease, and location. Use https://skills.duaer.com/proteins.md.
- Variants in a gene. Use https://skills.duaer.com/variants.md.
- Official HGNC nomenclature records. Use https://skills.duaer.com/hgnc.md.

## Call

`GET https://api.duaer.com/v1/data/genes?symbol=INS`

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 `q`, `symbol`, or `id`. When you send more than one, Duaer uses `id` if it is a number, else `symbol`, else `q`.

- `q` — Words in the gene symbol, name, or summary.
- `symbol` — Official gene symbol, such as `INS`.
- `id` — NCBI Gene id, such as `3630`. Reuse `geneId` from a result for an exact lookup.
- `species` — Optional. Species for `q` and `symbol`, such as `human`, `mouse`, or a taxonomy id. Default `human`. Ignored with `id`.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/genes?symbol=INS` — human insulin gene.
- `GET https://api.duaer.com/v1/data/genes?symbol=Trp53&species=mouse` — mouse p53 gene.
- `GET https://api.duaer.com/v1/data/genes?id=3630` — one gene by NCBI Gene id.

## Result

The response is `{ "items": [...] }`. Each item has `source` (`MyGene`), `title`, `url`, and `summary`, plus:

- `geneId` — NCBI Gene id.
- `symbol`, `name` — official symbol and full name.
- `aliases` — other symbols.
- `ensemblId` — Ensembl gene id.
- `taxId` — NCBI taxonomy id of the species.
- `mapLocation` — cytogenetic location, such as `11p15.5`.
- `typeOfGene` — gene type, such as `protein-coding`.

Use `symbol` as `gene` in https://skills.duaer.com/proteins.md and https://skills.duaer.com/variants.md.

For tissue expression, use https://skills.duaer.com/expression.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/proteins.md — Duaer proteins
- https://skills.duaer.com/variants.md — Duaer variants
- https://skills.duaer.com/pathways.md — Duaer pathways
- https://skills.duaer.com/gene-ontology.md — Duaer Gene Ontology
- https://skills.duaer.com/expression.md — Duaer expression
- https://skills.duaer.com/atlas.md — Duaer tissue atlas
- https://skills.duaer.com/geo.md — Duaer GEO
- https://skills.duaer.com/drug-gene.md — Duaer drug–gene
- https://skills.duaer.com/life-research-brief.md — Digital employee: Life research brief

Questions

Where do I use a gene from Duaer?

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

In this section