Get started
Search protein structures in Duaer
In Duaer, search protein structures with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.
What you get
Structures in Duaer data searches protein structures from a public structure source. One successful search uses 1 credit.
Add the node from the Duaer Data category (Structures).
Search on the canvas
- Open the node creator, select Duaer Data, then Structures.
- Fill at least one of Words, PDB ID, Organism, Method, Resolution from/to, Released from/to, Polymer, Ligand.
- 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
The skill for calling this data.
---
name: duaer-structures
description: >-
Duaer structures. Search protein structures.
One successful search uses 1 Duaer credit.
---
# Duaer structures
Search protein structures. Data comes from RCSB PDB.
## When to use
- Find experimental 3D structures of a protein in an organism.
- Filter structures by method, resolution, release date, or bound ligand.
## When not to use
- Predicted models without an experimental structure. Use https://skills.duaer.com/alphafold.md.
## 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.
Get a Duaer key: https://skills.duaer.com/keys.md
## Parameters
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.
## Examples
- `GET https://api.duaer.com/v1/data/structures?q=insulin&organism=Homo%20sapiens&method=X-RAY%20DIFFRACTION&resolutionTo=2.5&limit=10` — human insulin X-ray structures at 2.5 Å or better.
## Result
The response is `{ "items": [...] }`. Each item has `source` (`RCSB PDB`), `title`, `url`, and `summary`, plus:
- `pdbId`, `method`, `resolution`, `organism`, `released`, `ligand` — 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/proteins.md — Duaer proteins
- https://skills.duaer.com/compounds.md — Duaer compounds
- https://skills.duaer.com/genes.md — Duaer genes
- https://skills.duaer.com/alphafold.md — Duaer AlphaFold
Questions
What unit is resolution in?
Angstroms. 0 or empty on Resolution from/to means no bound.
In this section
Search proteins in Duaer
In Duaer, search genes and proteins with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.
Get startedSearch organisms in Duaer
In Duaer, search UniProt taxonomy with Duaer Data. One successful search uses 1 credit. Use the scientific name with proteins/structures organism, and taxonId with taxonomyId. This page includes the full English call skill.
Get startedSearch clinical trials in Duaer
In Duaer, search clinical trials with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.
Get startedSearch compounds in Duaer
In Duaer, search compounds and drugs with Duaer Data. One successful search uses 1 credit; a name that matches nothing uses 0. This page includes the full English call skill.
Get startedSearch 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.
Get startedLook up AlphaFold structures in Duaer
In Duaer, look up AlphaFold predicted structures by gene or UniProt accession with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.