Search protein structures in Duaer

What you get

Structures in the Duaer data market searches protein structures from a public structure source. One successful search uses 1 credit.

Add the node from the Duaer Data category (Structures), or copy the skill on the data market.

Search on the canvas

1. Open the node creator, select Duaer Data, then Structures.
2. Fill at least one of Words, PDB ID, Organism, Method, Resolution from/to, Released from/to, Polymer, Ligand.
3. Limit defaults to 10, max 20. Select Execute step.

A successful search uses 1 credit. Items include pdbId, method, resolution, organism, released, ligand, and more. Production deliverables land in the data pool.

Call the API

• GET https://api.duaer.com/v1/data/structures?...
• 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 full English call skill.

Call skill

Same text as Copy skill on the Duaer data market.

---
name: duaer-structures
description: >-
  Search protein structures through Duaer. One successful search uses 1 Duaer credit.
---

# Duaer structures

Search protein structures through Duaer with a Duaer key.

## Call

`GET https://api.duaer.com/v1/data/structures?q=insulin&organism=Homo%20sapiens&method=X-RAY%20DIFFRACTION&resolutionTo=2.5&limit=10`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

At least one search field is required. Fields combine.

- `q` — words in the structure record.
- `pdbId` — structure id, such as `4HHB`.
- `organism` — scientific name. Look up formal names with https://skills.duaer.com/organisms.md.
- `method` — experimental method, such as `X-RAY DIFFRACTION`, `SOLUTION NMR`, or `ELECTRON MICROSCOPY`.
- `resolutionFrom`, `resolutionTo` — resolution in angstroms. `0` means no bound.
- `releasedFrom`, `releasedTo` — release date as `YYYY-MM-DD`.
- `polymer` — `protein`, `dna`, or `rna`.
- `ligand` — bound chemical name.
- `limit` — optional. From 1 to 20. Default 10.

## Result

Each item has `source`, `title`, `url`, `summary`, `pdbId`, `method`, `resolution`, `organism`, `released`, and `ligand`.

## 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.