Drug Recalls and Adverse Events API: openFDA

Look up FDA drug recalls (enforcement reports) and aggregated adverse-event reaction counts by drug name, straight from openFDA.

原始信息汇总

数据集总览

Drug Recalls and Adverse Events API: openFDA 是一个基于美国食品药品监督管理局（FDA）openFDA 数据构建的 API 代理服务，专注于提供药品召回（强制执法报告）和药品不良事件（FAERS 报告）的聚合数据查询功能。该 API 适用于药物警戒仪表盘、召回监控工具、患者安全系统及制药竞争情报分析等场景。

---

核心功能与端点

端点	功能描述
GET /drugs/{name}/recalls?limit=	获取包含指定药品名称的 FDA 执法报告（召回信息），返回召回编号、状态、分类、产品描述、召回原因、企业名称、日期及分销范围等结构化数据。
GET /drugs/{name}/adverse-events?limit=	获取该药品上报的 TOP 不良事件反应术语及次数统计，数据来源标注为 openFDA FAERS，并附带“不构成因果关系”的免责声明。

两者均支持通过 limit 参数控制返回条数。

---

数据源与许可

• 数据来源：openFDA（美国食品药品监督管理局）的药品执法与 FAERS 不良事件数据集。
• 许可说明：数据属于美国联邦政府公有领域作品（public domain）。

---

使用限制与性能说明

• 缓存机制：召回数据缓存 12 小时，不良事件数据缓存 24 小时（边缘缓存）。
• 上游限制：openFDA 自身无 SLA，且未使用 API 密钥时每 IP 每日最多 1,000 次请求；超出后将返回 UPSTREAM_RATE_LIMITED 错误，需至次日恢复。可配置免费的 openFDA API 密钥以提高限额。
• 数据性质：不良事件计数为聚合报告数，非经核实的事实，不表示药物与反应间存在因果关系。

---

错误处理

API 返回 JSON 格式错误信息，统一结构为 { "error": "<code>", "message": "<text>" }，并设置 Cache-Control: no-store。错误码及对应 HTTP 状态如下：

错误码	HTTP 状态	触发条件
INVALID_NAME	400	药品名称长度需为 2–100 字符
INVALID_LIMIT	400	召回查询 limit 范围 1–50；不良事件 limit 范围 1–100
UPSTREAM_UNAVAILABLE	503	上游服务超时、错误或返回非法 JSON
UPSTREAM_RATE_LIMITED	429	超出上游速率限制
METHOD_NOT_ALLOWED	405	仅支持 GET 方法
QUERY_TOO_LONG	414	查询字符串超过 512 字符

---

定价模式

API 提供免费基础套餐及 PRO（$12/月）、ULTRA（$39/月）、MEGA（$99/月）四级付费订阅，具体权益需查看订阅计划详情。

---

示例数据

• 召回示例（GET /drugs/ibuprofen/recalls）返回包含召回编号（如 D-1234-2023）、状态（Ongoing）、分类（Class II）、产品描述、召回原因、召回企业、日期及分销模式等字段的 JSON 数组。
• 不良事件示例（GET /drugs/ibuprofen/adverse-events）返回药品名、反应术语及计数（如 NAUSEA: 120, HEADACHE: 80），并附数据来源与免责声明。