Duaer

Get started

Search mechanisms in Duaer

In Duaer, search ChEMBL mechanisms of action by molecule with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.

What you get

Mechanisms in Duaer data returns ChEMBL mechanisms of action (type, target, max phase). One successful search uses 1 credit.

Add the node from the Duaer Data category (Mechanisms). Related: Compounds and Indications.

Search on the canvas

  1. Open the node creator, select Duaer Data, then Mechanisms.
  2. Molecule is required (a new node starts with aspirin). Names or CHEMBL ids work.
  3. Limit defaults to 10, max 20; results prefer higher max phase. 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/mechanisms?...
  • Authorization: Bearer <Duaer key>
  • molecule 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-mechanisms
description: >-
  Duaer mechanisms. Search ChEMBL mechanisms of action by molecule.
  One successful search uses 1 Duaer credit.
---

# Duaer mechanisms

Search ChEMBL mechanisms of action by molecule. Data comes from ChEMBL.

## When to use

- Get the mechanism of action and target of a drug.
- Check the action type, such as inhibitor or agonist.

## When not to use

- Measured bioactivities. Use https://skills.duaer.com/activities.md.

## Call

`GET https://api.duaer.com/v1/data/mechanisms?molecule=aspirin&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

`molecule` is required.

- `molecule` — molecule name or ChEMBL id (`CHEMBL25`). Names resolve via ChEMBL search. Look up PubChem names with https://skills.duaer.com/compounds.md.
- `limit` — Optional. From 1 to 20. Default 10. Results prefer higher max phase.

## Examples

- `GET https://api.duaer.com/v1/data/mechanisms?molecule=aspirin&limit=10` — mechanisms of aspirin.

## Result

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

- `mechanismId`, `moleculeChemblId`, `mechanismOfAction`, `actionType`, `targetChemblId` — text.
- `maxPhase` — number.
- `directInteraction` — true or false.

Reuse `moleculeChemblId` / names when searching compounds, activities, or indications. Reuse `targetChemblId` when searching activities or targets.

Fields without a value are empty strings.

## Credits

A successful search uses 1 credit, even when it finds nothing.
If you send a `molecule` that ChEMBL 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/compounds.md — Duaer compounds
- https://skills.duaer.com/activities.md — Duaer activities
- https://skills.duaer.com/indications.md — Duaer indications

Questions

How are Duaer mechanism results ordered?

By max phase for the mechanism, highest first.

In this section