Clinical Trial Search API
收藏官方服务:
资源简介:
Search and retrieve structured clinical-trial records by condition, intervention, status, phase, location, or NCT ID. Get normalized study details, eligibility, sponsors, outcomes, and locations in JSON.
创建时间:
2026-09-05
原始信息汇总
Clinical Trial Search API 数据集详情总结
数据集概述
Clinical Trial Search API 是一个用于搜索和检索结构化临床试验记录的API,支持按疾病状况(condition)、干预措施(intervention)、状态(status)、阶段(phase)、地点(location)或NCT ID进行查询。该API以JSON格式返回规范化的研究详情,包括资格标准、赞助方、结果和地点等信息。
核心功能
- 支持按疾病、干预措施、地点、招募状态、研究阶段或自由文本术语进行搜索
- 可按NCT ID检索单个或多个试验研究
- 支持按国家过滤搜索结果
- 返回规范化的研究详情(JSON格式)
- 可选包含完整的原始记录
- 自动重试临时服务故障
- 通过短期缓存实现快速响应
- 限制结果集大小以防止请求过大
API接口说明
主要端点
| 端点 | 方法 | 功能说明 |
|---|---|---|
/search |
GET | 搜索临床试验记录(需至少提供一个搜索筛选条件) |
/studies/{nctId} |
GET | 按NCT ID获取单个试验研究(格式为NCT+8位数字) |
/studies |
GET | 按多个NCT ID批量获取研究(逗号分隔,单次最多100个) |
/studies |
POST | 批量获取研究(JSON请求体,支持includeRaw参数) |
搜索参数
| 参数 | 类型 | 说明 |
|---|---|---|
term |
string | 自由文本搜索表达式 |
condition |
string | 疾病或状况 |
intervention |
string | 药物、设备、程序或干预措施 |
location |
string | 城市、地区或国家 |
country |
string | 筛选返回的研究地点 |
status |
string | 逗号分隔的招募状态 |
phase |
string | 逗号分隔的研究阶段 |
studyType |
string | 研究类型,如INTERVENTIONAL |
maxResults |
integer | 最大返回记录数(默认100,最大1000) |
pageSize |
integer | 内部请求页面大小(默认100,最大1000) |
includeRaw |
boolean | 是否包含完整原始记录 |
响应格式与数据字段
成功响应使用统一JSON结构,包含data数组(内容因模式而异)和meta元数据对象。研究记录可能包含以下共同字段:
- 研究标识符和标题
- 招募状态、研究类型和阶段
- 开始和完成日期
- 登记信息
- 年龄范围和资格标准
- 疾病状况和关键词
- 干预措施和研究组别
- 主要、次要及其他结果
- 赞助方和合作者
- 相关人员及参考文献
- 研究地点和坐标
- 可选完整原始记录
响应中通过served_from_cache、stale_cache和_provenance.fetched_at字段指示数据是否来自缓存及缓存新鲜度。
错误处理
错误使用一致JSON结构,主要错误代码包括:
| 代码 | 含义 |
|---|---|
INVALID_REQUEST |
无效或不完整的请求参数 |
NOT_FOUND |
请求的端点不存在 |
UPSTREAM_ERROR |
获取数据的临时故障 |
注意:当请求多个NCT ID时,某个不可用的研究会以单条记录错误形式返回,而不会导致整个请求失败。
其他信息
- API版本:1.0.0(当前)
- 类别:Medical(医疗)
- 提供方:zenAPI
- 价格方案: BASIC($0.00/月)、PRO($19.00/月)、ULTRA($49.00/月)、MEGA($149.00/月)
- 性能指标:服务级别70%、延迟31043ms、测试通过率50%、流行度8.8
- 认证方式:通过RapidAPI自动提供认证,需在请求中包含
X-RapidAPI-Key和X-RapidAPI-Host头信息 - 数据新鲜度:响应可能来自短期缓存,重要记录需在使用前进行核实;该API不用于确定患者资格、治疗适宜性、安全性或有效性



