Duaer

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

  1. Open the node creator, select Duaer Data, then Papers — or search for Duaer Data / paper and connect the node after the previous node.
  2. Leave Operation on Papers.
  3. 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.
  4. Sort defaults to relevance; optionally Most cited. Limit defaults to 10, max 20.
  5. 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