药品
概览
按 set id 归集的美国药品说明书：一种药获批做什么，必须警示什么。
- 状态
- live
- 文档 id
set_id如f5e548d0-cc79-4c34-a3f5-e20a5b8b6564- 引用格式
[openFDA SPL f5e548d0…]- 更新于
- 2026-10
常用调用
找说明书
POST /v1/drugs/search {"query": "GLP-1 受体激动剂 减重", "filters": {"has_boxed_warning": true}}读一份
GET /v1/drugs/read/<set_id> → 适应症、禁忌、相互作用、黑框要点、药理类别按药理类别筛
GET /v1/drugs/facets?field=pharm_class_epc细则
- 67%（171,903 份）是 product_type=UNMAPPED：这些 SPL 没有 openfda 映射块，通用名/途径/药理类别可能为空，品名看 spl_name。
- 一个 set_id 只保留 effective_time 最新的一版，没有历史版本。
- 适应症与禁忌是模型抽取的要点，用药决策请回说明书原文。
- 不是医疗建议。
- 检索库里没有正文：level=full 暂不可用（说明书各节原文在 NAS openfda/label，检索库里只有节名与 token 数（sections））。
检索
POST
/v1/drugs/search混合检索，每条命中一张卡片。2 credits。免费样例：
semaglutide weight loss。过滤字段
| 字段 | 类型 · op | 含义 |
|---|---|---|
| route | keyword · eq anyORAL · TOPICAL · INTRAVENOUS · INTRAMUSCULAR · SUBCUTANEOUS · OPHTHALMIC …共 13 个，/facets 可列全 | 给药途径 |
| product_type | keyword · eq anyHUMAN PRESCRIPTION DRUG · HUMAN OTC DRUG · CELLULAR THERAPY · UNMAPPED | 产品类型；UNMAPPED = 该 SPL 没有 openfda 映射块 |
| is_rx | bool · eq | 是否处方药 |
| has_boxed_warning | bool · eq | 是否有黑框警告 |
| pharm_class_epc | keyword · eq any | 药理类别（EPC，建立的疗效分类） |
| effective_year | integer · eq range | 说明书版本年份区间 |
还有 8 个，照样能用
| 字段 | 类型 · op | 含义 |
|---|---|---|
| generic_name | keyword · eq any | 通用名（精确） |
| substance_names | keyword · eq any | 活性成分 |
| pharm_class_moa | keyword · eq any | 药理类别（MoA，作用机制） |
| manufacturer | keyword · eq any | 标签持有人/厂商（精确） |
| rxcui | keyword · eq any | RxNorm 概念 id |
| unii | keyword · eq any | 成分 UNII |
| product_ndc | keyword · eq any | NDC 产品码 |
| application_number | keyword · eq any | FDA 申请号（NDA / ANDA / BLA） |
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| query 必填 | string | 1–1000 字符。也可以是最多 5 条的数组（批量，hits 变 results[]）。 |
| top_k | integer= 10 | 1–100。 |
| fields | brief · head= brief | head 多扣 1 credit，每条附 head 视图。 |
| filters | json | 过滤 DSL 对象（见快速开始）；可用字段见上表。 |
| mode | hybrid · dense · bm25= hybrid | 检索模式。不传就用第一个。 |
| offset | integer= 0 | 翻页。 |
示例
{ "domain": "drugs", "query": "…", "hits": [ { "id": "f5e548d0-cc79-4c34-a3f5-e20a5b8b6564", "score": 0.83, "brief": { … } } ], "total": null, "coverage": …, "warnings": [],
"meta": { "request_id": "req_…", "credits": { "charged": 2, "balance": 1998, "pool": "allowance" }, "latency_ms": 41, "cached": false } } 用了未声明的过滤字段返回 400，不会静默忽略。过滤条件是 AND；可用
_or / _not。读
GET
/v1/drugs/read/{set_id}三档深浅，不传就是
detail。免费样例：f5e548d0-cc79-4c34-a3f5-e20a5b8b6564。三档
| 深浅 | credits | 返回 |
|---|---|---|
| brief | 1 | 卡片：做取舍够用的字段（检索结果里那张） |
| detail （默认） | 2 | 全部结构化字段（规则字段 + 模型字段，模型字段在 _enrich.fields 里列名） |
| full | 5 | 全文（建设中：说明书各节原文在 NAS openfda/label，检索库里只有节名与 token 数（sections）） |
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| set_id (path) 必填 | string | 文档 id（set_id）。 |
| level | brief · detail · full= detail | 读多深。 |
| format | json · md · html= json | 响应形态。 |
示例
{ "domain": "drugs", "id": "f5e548d0-cc79-4c34-a3f5-e20a5b8b6564", "level": "detail", "view": "head", "data": { … } | "text": "…", "token_count": 1834, "meta": { … } } 旧写法
GET /v1/drugs/doc/{id}?view=… 仍然可用。批量读
POST
/v1/drugs/read最多 50 个 id，同一档。查不到的 id 返回
error: "not_found"，不扣费。参数
| 参数 | 类型 | 说明 |
|---|---|---|
| ids 必填 | string[] | 文档 id 列表。 |
| level | brief · detail · full= detail | 所有 id 共用的档。 |
示例
{ "domain": "drugs", "level": "detail", "docs": [ { "id": "…", "data": { … } }, { "id": "…", "error": "not_found" } ], "meta": { … } } Facets
GET
/v1/drugs/facets?field={field}某个过滤字段的合法值，agent 不用猜；预聚合字段带计数，声明的枚举没有。免费、不需要 key。
参数
| 参数 | 类型 | 说明 |
|---|---|---|
| field 必填 | route · product_type · pharm_class_epc | 有 facets 的过滤字段。 |
| limit | integer= 50 | 最多返回多少个值。 |
示例
{ "domain": "drugs", "field": "…", "values": [ { "value": "…", "count": 3120 } ], "meta": { … } } 问registered key+ /stream
POST
/v1/drugs/ask本域的 agentic 问答：模型按自描述把问题翻成检索（筛选 + 关键词），读详情后作答，引用写成 [drugs: <标题>]；/stream 为 NDJSON，answer_delta 是边生成边发的真实片段。
effort low / medium / high 对应 50 / 100 / 200 credits。加 /stream 走 NDJSON，第一个事件一定是 billing。首个 answer_delta 之前失败会退款。参数
| 参数 | 类型 | 说明 |
|---|---|---|
| query 必填 | string | 1–2000 字符。问得具体；要数字就直接问数字。 |
| effort | low · medium · high= low | 检索轮数，也决定价格：50 / 100 / 200 credits。套餐限制最高档。 |
| verbose | bool= false | 返回工具调用轨迹（流式时多 tool_call / tool_result / thinking 事件）。 |
| top_k | integer= 10 | 预取候选数。 |
| stream_answer | bool= true | 仅流式：false 时只发一个 answer 事件。 |
| max_rounds | integer | 0–8，覆盖 effort 预设。 |
| force_answer_after | number | 秒；强制切入作答阶段。 |
| max_answer_tokens | integer= 4096 | 触顶时置 answer_truncated。 |
| language | string | 回答语言，默认跟随 query。 |
示例
{ "answer": "… [openFDA SPL f5e548d0…] …", "sources": [ … ], "stats": { "rounds": 1, "elapsed_s": 6.2, "answer_truncated": false }, "coverage"?: { … }, "meta": { "credits": { "charged": 50, … } } } 引用是真的——
answer 里的每个 id 都存在于本垂域（格式 [openFDA SPL f5e548d0…]）。sources 是召回集，不是引用列表。answer_truncated 表示不完整。