Get started
Fetch a spectrum by USI in Duaer
In Duaer, fetch the peaks of a public mass spectrum by its USI. One successful search uses 1 credit.
What you get
Spectrum by USI in Duaer data uses 1 credit per successful search, including a search with no match.
Pass the returned peaks to MassBank spectra or MASST.
To work an unknown feature step by step, see Annotate an unknown feature with Duaer.
Search on the canvas
- Open the node creator, pick Duaer Data → Spectrum by USI.
- Fill USI (starts with mzspec:).
- Limit defaults to 10, max 20. Execute.
A successful search uses 1 credit. Empty input or a failed source uses 0.
Call the API
- GET https://api.duaer.com/v1/data/spectrum?...
- Authorization: Bearer <Duaer key>
The call skill is below.
Call skill
The skill for calling this data.
---
name: duaer-spectrum
description: >-
Duaer spectrum by USI. Fetch the peaks of a public mass spectrum by its USI.
One successful search uses 1 Duaer credit.
---
# Duaer spectrum by USI
Fetch the peaks of a public mass spectrum by its USI. Data comes from GNPS USI.
## When to use
- Fetch the peaks of a public spectrum by USI.
- Get peaks to pass to a spectrum match.
## When not to use
- Find datasets that contain a spectrum. Use https://skills.duaer.com/masst.md.
## Call
`GET https://api.duaer.com/v1/data/spectrum?usi=mzspec:GNPS:GNPS-LIBRARY:accession:CCMSLIB00005435737`
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
- `usi` — required. A USI that starts with `mzspec:` (GNPS, MassIVE, MetaboLights, and other public repositories).
## Examples
- `GET https://api.duaer.com/v1/data/spectrum?usi=mzspec:GNPS:GNPS-LIBRARY:accession:CCMSLIB00005435737` — peaks of one GNPS library spectrum.
## Result
The response is `{ "items": [...] }`. One item with `source`, `title`, `url` (spectrum viewer), `summary`, `usi`, `precursorMz`, `charge`, `peakCount`, `peaks` (`mz:intensity` pairs), and `splash`.
Pass `peaks` to https://skills.duaer.com/massbank.md, or the `usi` to https://skills.duaer.com/masst.md.
To work an unannotated feature step by step, follow https://skills.duaer.com/metabolic-dark-matter.md.
Fields without a value are empty strings or left out.
## 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/metabolic-dark-matter.md — Duaer: annotate an unknown feature (metabolic dark matter)
- https://skills.duaer.com/massbank.md — Duaer MassBank spectra
- https://skills.duaer.com/masst.md — Duaer MASST
Questions
How many credits does a Spectrum by USI search use in Duaer?
One successful search uses 1 credit, including a search with no match. Empty input or a failed source uses 0.
In this section
Annotate an unknown feature with Duaer
In Duaer, work an MS feature that no library identified: library match, mass candidates, reference spectra, and MASST, one Duaer Data call per step.
Get startedMatch spectra in MassBank with Duaer
In Duaer, match MS/MS peaks, an exact mass, or an InChIKey against MassBank. One successful search uses 1 credit.
Get startedSearch a spectrum with MASST in Duaer
In Duaer, find where an MS/MS spectrum appears in public metabolomics data with GNPS2 MASST. One successful search uses 1 credit.