Get started
Search papers in Duaer
In Duaer, search published papers with the Duaer Data node or the public API. One successful search uses 1 credit. This page includes the full English call skill.
What Papers returns
Papers in Duaer data searches published papers. Each item has source, title, url, and summary. The price is 1 credit per successful search.
Add the node from the Duaer Data category by choosing Papers. All fetchable data is in the Duaer data catalog. Related life-science data includes Proteins. Opening the market or copying the skill does not charge credits and does not run a search.
Use Duaer Data on the canvas
- Open the node creator, select Duaer Data, then Papers — or search for Duaer Data / paper and connect the node after the previous node.
- Leave Operation on Papers.
- Fill at least one search field: Words, Title, Abstract, Author, Year From / Year To (0 means any), or Type, Open Access, Citations, Language, DOI, Journal, Institution, Topic.
- Sort defaults to relevance; optionally Most cited. Limit defaults to 10, max 20.
- Select Execute step.
A successful search uses 1 credit. An empty search, a failed search, or no remaining credits uses 0. When this node is the deliverable of a production run, items land in the data pool.
Duaer stamps a loopback URL and bearer onto the node at run time so it hits the same charged route. You do not enter a key in the panel.
Call the API
External agents or scripts call:
- GET https://api.duaer.com/v1/data/papers?...
- Header Authorization: Bearer <Duaer key> (account key or model API key).
- At least one search field is required; fields combine. limit is optional, 1–20, default 10.
- Success returns { "items": [{ "source", "title", "url", "summary" }] }. One successful search uses 1 credit; no credits returns 402; a missing key returns 401.
For keys, refer to Authentication for the Duaer public API. Below is the full English call skill — paste it into an external agent.
Call skill
The skill for calling this data. Keep it English so models can load it.
---
name: duaer-papers
description: >-
Duaer papers. Published papers from OpenAlex by words, title, abstract, author, year, type, open access, citations, language, DOI, journal, institution, or topic.
One successful search uses 1 Duaer credit.
---
# Duaer papers
Duaer papers searches published works in OpenAlex: articles, reviews, preprints, books, datasets, and more. Filters combine. Results are ordered by relevance unless you sort by citations.
## When to use
- Find the most cited papers on a topic in a range of years.
- Check what an author or institution published.
- Resolve a DOI to its title and abstract.
## When not to use
- Preprints from bioRxiv or medRxiv only. Use https://skills.duaer.com/preprints.md.
- Research grants. Use https://skills.duaer.com/grants.md.
- Patents. Use https://skills.duaer.com/patents.md.
## Call
`GET https://api.duaer.com/v1/data/papers?title=lithium&author=Zhang&yearFrom=2020&yearTo=2024&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
Provide at least one search field. `sort` and `limit` alone are not a search.
- `q` — Optional. Words in the title, abstract, or full text.
- `title` — Optional. Words in the title.
- `abstract` — Optional. Words in the abstract.
- `author` — Optional. Author name.
- `yearFrom`, `yearTo` — Optional. Publication years from 1000 to 2100. Leave a year out, or send `0`, for any year.
- `type` — Optional. Work type: `article`, `book`, `book-chapter`, `dataset`, `dissertation`, `editorial`, `erratum`, `letter`, `libguides`, `other`, `paratext`, `peer-review`, `preprint`, `reference-entry`, `report`, `retraction`, `review`, `standard`, or `supplementary-materials`.
- `openAccess` — Optional. `yes` or `no`.
- `citationsFrom`, `citationsTo` — Optional. Citation count. `0` means no bound.
- `language` — Optional. Language code, such as `en` or `zh`.
- `doi` — Optional. Digital object identifier, such as `10.1038/nature12373`.
- `journal`, `institution`, `topic` — Optional. Names. Duaer uses the closest OpenAlex match. A name with no match returns 400.
- `sort` — Optional. `citations` orders by most cited. Omit it for relevance.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.
## Examples
- `GET https://api.duaer.com/v1/data/papers?q=CRISPR%20base%20editing&yearFrom=2022&sort=citations` — most cited base editing papers since 2022.
- `GET https://api.duaer.com/v1/data/papers?doi=10.1038/nature12373` — one paper by DOI.
- `GET https://api.duaer.com/v1/data/papers?topic=lithium%20batteries&type=review&openAccess=yes` — open access reviews on a topic.
## Result
The response is `{ "items": [...] }`. Each item has:
- `source` — `OpenAlex`.
- `title` — work title.
- `url` — DOI link, or the OpenAlex page when there is no DOI.
- `summary` — abstract, up to 1000 characters. Empty when OpenAlex has no abstract.
## 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/trials.md — Duaer clinical trials
- https://skills.duaer.com/diseases.md — Duaer diseases
- https://skills.duaer.com/preprints.md — Duaer preprints
- https://skills.duaer.com/grants.md — Duaer grants
- https://skills.duaer.com/patents.md — Duaer patents
- https://skills.duaer.com/life-research-brief.md — Digital employee: Life research brief
Questions
How many credits does a Duaer paper search use?
One successful search uses 1 credit (including limit 20). Empty, failed, or no-credit searches use 0.
Where do I copy the call skill?
Select Copy skill next to the Call skill block on this page.
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 startedAdd a node from the Duaer Data category
In Duaer’s node creator, Duaer Data is a category for data Duaer can fetch. Open it, pick a data type (Papers through Drug labels), and Duaer adds the Duaer Data node to the canvas.
Get startedDuaer data catalog
External data Duaer can fetch, what you get, and the price. Add a node from the Duaer Data category in the node creator, or give an agent the skill.
APIAuthentication for the Duaer public API
Duaer uses API keys to authenticate public REST API calls.