> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/getting-started/structures.md).

# 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 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](/getting-started/duaer-data.md) (Structures), or copy the skill on the [data market](/getting-started/data-market.md).

## 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](/getting-started/data-pool.md).

## 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](/api/authentication.md). 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.

```
## Questions

### What unit is resolution in?

Angstroms. 0 or empty on Resolution from/to means no bound.

## Related

- [Search proteins in Duaer](https://doc.duaer.com/getting-started/proteins.md)
- [Search organisms in Duaer](https://doc.duaer.com/getting-started/organisms.md)
- [Search clinical trials in Duaer](https://doc.duaer.com/getting-started/trials.md)
- [Search compounds in Duaer](https://doc.duaer.com/getting-started/compounds.md)
- [Search diseases in Duaer](https://doc.duaer.com/getting-started/diseases.md)