遇见数据集

Clinical Trial Search API

收藏
RapidAPI2026-09-05 更新2026-09-06 收录
官方服务:

资源简介:

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_cachestale_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-KeyX-RapidAPI-Host头信息
  • 数据新鲜度:响应可能来自短期缓存,重要记录需在使用前进行核实;该API不用于确定患者资格、治疗适宜性、安全性或有效性
二维码
社区交流群
二维码
科研交流群
商业服务