> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/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/zh/getting-started/trials.md).

# 在 Duaer 里检索临床试验

在 Duaer 里用 Duaer Data 检索临床试验。一次成功查询 1 额度。本页含完整英文调用技能。
## 能拿到什么

Duaer 数据市场里的「临床试验」按公开试验登记检索。一次成功查询 1 额度。

从 [Duaer 数据分类](/zh/getting-started/duaer-data.md) 选「临床试验」，或在 [数据市场](/zh/getting-started/data-market.md) 复制技能。

## 在画布里检索

1. 打开节点创建器，点「Duaer 数据」，再选「临床试验」。
2. 至少填一项：Condition、Other words、Intervention、Location、Title、Outcome、Sponsor、Lead sponsor、NCT ID、Status、Phase。Sort 单独不算检索。
3. Sort 可选 Recently updated。Limit 默认 10，最大 20。点执行此步骤。

成功扣 1 额度。结果含 nctId、status、phase、conditions、interventions、sponsor、startDate 等。正式运行交付进 [数据池](/zh/getting-started/data-pool.md)。

## 用 API 调用

- GET https://api.duaer.com/v1/data/trials?...
- Authorization: Bearer <Duaer key>
- 字段可组合；至少填一个检索字段。sort 单独不算检索。

密钥见 [Duaer 公开 API 的身份验证](/zh/api/authentication.md)。下方是完整英文调用技能。

## 调用技能（英文）

与数据市场「复制技能」一致。

```
---
name: duaer-trials
description: >-
  Search clinical trials through Duaer. One successful search uses 1 Duaer credit.
---

# Duaer trials

Search clinical trials through Duaer with a Duaer key.

## Call

`GET https://api.duaer.com/v1/data/trials?condition=diabetes&intervention=insulin&status=RECRUITING&limit=10`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

At least one search field is required. Sort alone is not a search. Fields combine.

- `condition` — disease or condition.
- `term` — other words.
- `intervention` — drug, device, or other intervention.
- `location` — where the study runs.
- `title` — words in the title.
- `outcome` — words in the outcome.
- `sponsor` — sponsor name.
- `lead` — lead sponsor name.
- `nctId` — study id.
- `status` — recruitment status, such as `RECRUITING` or `COMPLETED`.
- `phase` — `EARLY_PHASE1`, `PHASE1`, `PHASE2`, `PHASE3`, `PHASE4`, or `NA`.
- `sort` — `recent` orders by last update. Omit it for relevance.
- `limit` — optional. From 1 to 20. Default 10.

## Result

Each item has `source`, `title`, `url`, `summary`, `nctId`, `status`, `phase`, `conditions`, `interventions`, `sponsor`, and `startDate`.

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

### 只选 Sort 能搜试验吗？

不能。Sort 单独不算检索，还要填至少一个检索字段。

## 相关

- [在 Duaer 里检索基因和蛋白](https://doc.duaer.com/zh/getting-started/proteins.md)
- [在 Duaer 里检索疾病](https://doc.duaer.com/zh/getting-started/diseases.md)
- [在 Duaer 里检索化合物和药物](https://doc.duaer.com/zh/getting-started/compounds.md)
- [在 Duaer 里检索蛋白结构](https://doc.duaer.com/zh/getting-started/structures.md)