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

# Search Ensembl in Duaer

In Duaer, look up Ensembl genes by symbol or id (coords, biotype) with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.
## What you get

Ensembl in the Duaer data market returns gene coordinates, biotype, and canonical transcript. One successful search uses 1 credit.

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

## Search on the canvas

1. Open the node creator, select Duaer Data, then Ensembl.
2. Enter Symbol (a new node starts with TP53), or an Ensembl ID. Species defaults to homo_sapiens.
3. Limit defaults to 10, max 20. Select Execute step.

A successful search uses 1 credit. Production deliverables land in the [data pool](/getting-started/data-pool.md).

## Call the API

- GET https://api.duaer.com/v1/data/ensembl?...
- Authorization: Bearer <Duaer key>
- words or id 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-ensembl
description: >-
  Look up Ensembl genes by symbol or id through Duaer.
  One successful search uses 1 Duaer credit.
---

# Duaer Ensembl

Look up Ensembl genes (coords, biotype, transcript) through Duaer with a Duaer key.

## Call

`GET https://api.duaer.com/v1/data/ensembl?words=TP53&species=homo_sapiens&limit=10`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Provide `words` (gene symbol) or `id` (Ensembl gene id).

- `words` — gene symbol, such as TP53.
- `id` — optional. Ensembl id such as ENSG00000141510.
- `species` — optional. Default homo_sapiens. Used with words.
- `limit` — optional. From 1 to 20. Default 10.

## Result

Each item has `source`, `title`, `url`, `summary`, `ensemblId`, `symbol`, `biotype`, `species`, `assembly`, `chromosome`, `start`, `end`, `strand`, `canonicalTranscript`, and `description`.
Related genes: https://skills.duaer.com/genes.md.
Related proteins: https://skills.duaer.com/proteins.md.

## 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 do Duaer Ensembl and Genes differ?

Genes uses MyGene (symbol, aliases, Entrez). Ensembl returns genomic coordinates, biotype, and the canonical transcript.

## Related

- [Search genes in Duaer](https://doc.duaer.com/getting-started/genes.md)
- [Search proteins in Duaer](https://doc.duaer.com/getting-started/proteins.md)
- [Search variants in Duaer](https://doc.duaer.com/getting-started/variants.md)
- [Use the Duaer data market](https://doc.duaer.com/getting-started/data-market.md)