Duaer

Get started

Search diseases in Duaer

In Duaer, search UniProt disease names with Duaer Data. One successful search uses 1 credit. Use the formal name with proteins.disease. This page includes the full English call skill.

What you get

Diseases in Duaer data searches the UniProt disease vocabulary. One successful search uses 1 credit.

Add the node from the Duaer Data category (Diseases). Use the formal name with Proteins Disease.

Search on the canvas

  1. Open the node creator, select Duaer Data, then Diseases.
  2. Words alone is enough (a new node starts with diabetes). Disease ID, Name, and Acronym are optional; Disease ID comes from diseaseId on a result.
  3. Limit defaults to 10, max 20. Select Execute step.

A successful search uses 1 credit. Items include source, title, url, summary, plus diseaseId, acronym, alternativeNames, and reviewedProteinCount. Use title as disease when searching proteins. Reuse diseaseId in Disease ID for an exact lookup. Production deliverables land in the data pool.

Call the API

  • GET https://api.duaer.com/v1/data/diseases?...
  • 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-diseases
description: >-
  Duaer diseases. Search disease names. Use the formal name with proteins.disease.
  One successful search uses 1 Duaer credit.
---

# Duaer diseases

Search disease names. Use the formal name with proteins.disease. Data comes from UniProt.

## When to use

- Get the formal UniProt disease name before searching proteins.
- Check the acronym and id of a disease.

## When not to use

- Disease ontology terms and cross-references. Use https://skills.duaer.com/mondo.md.

## Call

`GET https://api.duaer.com/v1/data/diseases?q=diabetes&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 one search field is required. Fields combine. Search with `q` first; use `id` or `acronym` only when you already have them from a result.

- `q` — words in the disease name or definition.
- `id` — Optional. UniProt disease id from a result (`diseaseId`), such as `DI-02060`.
- `name` — Optional. Disease name.
- `acronym` — Optional. Disease acronym from a result, such as `T2D`.
- `limit` — Optional. From 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/diseases?q=diabetes&limit=10` — diseases matching diabetes.

## Result

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

- `diseaseId`, `acronym`, `alternativeNames` — text.
- `reviewedProteinCount` — number.

Use `title` as `disease` when searching proteins. Reuse `diseaseId` in `id` for an exact lookup.

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/genes.md — Duaer genes
- https://skills.duaer.com/proteins.md — Duaer proteins
- https://skills.duaer.com/variants.md — Duaer variants
- https://skills.duaer.com/trials.md — Duaer clinical trials
- https://skills.duaer.com/indications.md — Duaer indications
- https://skills.duaer.com/cell-lines.md — Duaer cell lines

Questions

Where do I use a disease name from Duaer?

Put the item title into the Proteins Disease field (API disease) in Duaer.

In this section