> 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/papers.md).

# 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 the Duaer data market 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](/getting-started/duaer-data.md) by choosing Papers. The catalog entry is on [Use the Duaer data market](/getting-started/data-market.md). Related life-science data includes [Proteins](/getting-started/proteins.md). 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](/getting-started/data-pool.md).

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](/api/authentication.md). Below is the same English call skill as Copy skill on the data market page — paste it into an external agent.

## Call skill

Same text as Copy skill on the Duaer data market. Keep it English so models can load it.

````
---
name: duaer-papers
description: >-
  Search published papers through Duaer. Use when you need titles, links, and
  summaries. One successful search uses 1 Duaer credit.
---

# Duaer papers

Search papers through Duaer with a Duaer key.

## 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.

At least one search field is required. Fields combine.

- `q` — words in the title, abstract, or full text.
- `title` — words in the title.
- `abstract` — words in the abstract.
- `author` — author name.
- `yearFrom`, `yearTo` — publication year, from 1000 to 2100. Either or both.
- `type` — work type, such as `article`, `preprint`, or `review`.
- `openAccess` — `yes` or `no`.
- `citationsFrom`, `citationsTo` — citation count. `0` means no bound.
- `language` — code such as `en` or `zh`.
- `doi` — digital object identifier.
- `journal`, `institution`, `topic` — names. Duaer uses the closest match.
- `sort` — `citations` orders by most cited. Omit it for relevance.
- `limit` — optional. From 1 to 20. Default 10.

## Result

```json
{ "items": [{ "source": "", "title": "", "url": "", "summary": "" }] }
```

## Credits

One successful search uses 1 credit, including when `limit` is 20.
An empty search, a failed search, or no remaining credits uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

````
## 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 under Papers on the data market, or use the Call skill block on this page.

## Related

- [Search proteins in Duaer](https://doc.duaer.com/getting-started/proteins.md)
- [Add a node from the Duaer Data category](https://doc.duaer.com/getting-started/duaer-data.md)
- [Use the Duaer data market](https://doc.duaer.com/getting-started/data-market.md)
- [Authentication for the Duaer public API](https://doc.duaer.com/api/authentication.md)