Duaer

Get started

Search expression in Duaer

In Duaer, search GTEx median tissue expression with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.

What you get

Expression in Duaer data searches GTEx median TPM by tissue. One successful search uses 1 credit.

Add the node from the Duaer Data category (Expression). Related: Genes and Proteins.

Search on the canvas

  1. Open the node creator, select Duaer Data, then Expression.
  2. Gene or Gencode ID is required (a new node starts with Gene INS). Tissue is optional (for example Pancreas).
  3. Limit defaults to 10, max 20; results sort by median TPM descending. Select Execute step.

A successful search uses 1 credit. Production deliverables land in the data pool.

Call the API

  • GET https://api.duaer.com/v1/data/expression?...
  • Authorization: Bearer <Duaer key>
  • gene or gencodeId 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-expression
description: >-
  Duaer expression. Search GTEx median tissue expression.
  One successful search uses 1 Duaer credit.
---

# Duaer expression

Search GTEx median tissue expression. Data comes from GTEx.

## When to use

- Compare median expression of a gene across human tissues.
- Check expression in one tissue.

## When not to use

- Protein-level tissue enrichment. Use https://skills.duaer.com/atlas.md.

## Call

`GET https://api.duaer.com/v1/data/expression?gene=INS&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

At least `gene` or `gencodeId` is required.

- `gene` — gene symbol. Look up symbols with https://skills.duaer.com/genes.md.
- `gencodeId` — Optional. Ensembl/Gencode id from a result, such as `ENSG00000254647.6`.
- `tissue` — Optional. GTEx tissue id, such as `Pancreas` or `Adipose_Subcutaneous`.
- `limit` — Optional. From 1 to 20. Default 10. Results are sorted by median TPM descending.

## Examples

- `GET https://api.duaer.com/v1/data/expression?gene=INS&limit=10` — insulin expression by tissue.

## Result

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

- `gene`, `gencodeId`, `tissue`, `tissueLabel` — text.
- `median` — number.
- `unit`, `ontologyId`, `dataset` — text.

Reuse `gene` when searching proteins or genes. Reuse `gencodeId` in `gencodeId` for an exact expression lookup. For gene–disease associations, use https://skills.duaer.com/targets.md. For HPA tissue enrichment, use https://skills.duaer.com/atlas.md.

Fields without a value are empty strings.

## Credits

A successful search uses 1 credit, even when it finds nothing.
If you send a `gene` that GTEx does not know, Duaer returns no items and uses 0.
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/proteins.md — Duaer proteins
- https://skills.duaer.com/interactions.md — Duaer interactions
- https://skills.duaer.com/targets.md — Duaer targets
- https://skills.duaer.com/atlas.md — Duaer tissue atlas
- https://skills.duaer.com/geo.md — Duaer GEO

Questions

How are Duaer expression results ordered?

By median TPM descending across tissues; Limit keeps the top N rows.

In this section