Clinicaltrials Database API 参考

# ClinicalTrials.gov API v2 参考文档 ## 概述 ClinicalTrials.gov API v2 是一个现代化的 REST API，提供对 ClinicalTrials.gov 数据库的程序化访问，该数据库包含全球临床研究信息。该 API 遵循 OpenAPI Specification 3.0 标准，并提供 JSON 和 CSV 响应格式。 **基础 URL：** `https://clinicaltrials.gov/api/v2` **API 版本：** 2.0（2024 年 3 月发布，取代经典 API） ## 身份验证与速率限制 - **身份验证：** 无需（公开 API） - **速率限制：** 每个 IP 地址每分钟约 50 次请求 - **响应格式：** JSON（默认）或 CSV - **标准：** 日期使用 ISO 8601，富文本使用 CommonMark Markdown ## 核心端点 ### 1. 搜索研究 **端点：** `GET /api/v2/studies` 使用各种查询参数和过滤器搜索临床试验。 **查询参数：** | 参数 | 类型 | 描述 | 示例 | |-----------|------|-------------|---------| | `query.cond` | string | 疾病或病症搜索 | `lung cancer`, `diabetes` | | `query.intr` | string | 治疗或干预搜索 | `Pembrolizumab`, `exercise` | | `query.locn` | string | 地理位置过滤 | `New York`, `California, USA` | | `query.spons` | string | 申办方或合作者名称 | `National Cancer Institute` | | `query.term` | string | 通用全文搜索 | `breast cancer treatment` | | `filter.overallStatus` | string | 基于状态的过滤（逗号分隔） | `RECRUITING,NOT_YET_RECRUITING` | | `filter.ids` | string | NCT ID 交集过滤（逗号分隔） | `NCT04852770,NCT01728545` | | `filter.phase` | string | 研究阶段过滤 | `PHASE1,PHASE2` | | `sort` | string | 结果排序 | `LastUpdatePostDate:desc` | | `pageSize` | integer | 每页结果数（最大 1000） | `100` | | `pageToken` | string | 上次响应的翻页令牌 | `` | | `format` | string | 响应格式 (`json` 或 `csv`) | `json` | **有效状态值：** - `RECRUITING` - 正在招募参与者 - `NOT_YET_RECRUITING` - 尚未开始招募 - `ENROLLING_BY_INVITATION` - 仅限受邀招募 - `ACTIVE_NOT_RECRUITING` - 进行中但不再招募 - `SUSPENDED` - 暂时中止 - `TERMINATED` - 提前终止 - `COMPLETED` - 研究已结束 - `WITHDRAWN` - 在招募前撤回 **有效阶段值：** - `EARLY_PHASE1` - 早期 1 期（原 0 期） -