Duaer

Get started

Search drug–gene interactions in Duaer

In Duaer, search drug–gene interactions via DGIdb with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.

What you get

Drug–gene in Duaer data returns DGIdb interactions (gene, drug, type, score). One successful search uses 1 credit.

Add the node from the Duaer Data category (Drug–gene). Related: Genes and Compounds.

Search on the canvas

  1. Open the node creator, select Duaer Data, then Drug–gene.
  2. Enter Gene (a new node starts with EGFR) or Drug (such as imatinib); both may be set.
  3. Approved is optional (yes/no). Limit defaults to 10, max 20; results prefer higher interaction score. 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/drug-gene?...
  • Authorization: Bearer <Duaer key>
  • gene or drug 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-drug-gene
description: >-
  Duaer drug–gene. Search drug–gene interactions from DGIdb.
  One successful search uses 1 Duaer credit.
---

# Duaer drug–gene

Search drug–gene interactions from DGIdb. Data comes from DGIdb.

## When to use

- List drugs that interact with a gene.
- Keep only approved drugs.

## When not to use

- Mechanisms of action by drug. Use https://skills.duaer.com/mechanisms.md.

## Call

`GET https://api.duaer.com/v1/data/drug-gene?gene=EGFR&approved=yes&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

Provide `gene` or `drug` (or both).

- `gene` — gene symbol (e.g. `EGFR`).
- `drug` — drug name (e.g. `imatinib`).
- `approved` — Optional. `yes` or `no` to keep only approved or unapproved drugs.
- `limit` — Optional. From 1 to 20. Default 10. Results prefer higher interaction score.

## Examples

- `GET https://api.duaer.com/v1/data/drug-gene?gene=EGFR&approved=yes&limit=10` — approved drugs for EGFR.

## Result

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

- `gene`, `geneConceptId`, `drug`, `drugConceptId` — text.
- `approved` — true or false.
- `interactionTypes` — text.
- `interactionScore` — number.
- `sources` — text.

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/compounds.md — Duaer compounds
- https://skills.duaer.com/targets.md — Duaer targets

Questions

Must I set both Gene and Drug in Duaer Drug–gene?

Provide at least one. Gene alone lists drugs for that gene; Drug alone lists genes for that drug.

In this section