NDC Drug Code Lookup API

FDA National Drug Code (NDC) directory — 100,000+ drug products with package-level detail, DEA schedule, substance, dosage form, and route filters. Built for pharma, healthtech, and compliance workflows.

原始信息汇总

NDC Drug Code Lookup API 数据集概述

该API提供对美国FDA国家药品代码（NDC）目录的程序化访问，是覆盖美国商业分销药品的权威注册信息。数据集包含超过100,000种药品产品及其包装细节。

数据覆盖范围

• 药品产品：涵盖所有在美国销售的处方药、非处方药（OTC）和生物制品。
• DEA受控物质：支持按DEA管制分类（CI至CV）进行查询。

数据实体与字段

数据集包含两类核心实体：产品和包装。

产品实体 (ndc_product) 字段

字段	类型	描述
product_id	string	FDA内部产品标识
product_ndc	string	NDC产品代码，格式为 XXXXX-XXXX
product_type	string	产品类型（如 HUMAN PRESCRIPTION DRUG）
proprietary_name	string	品牌名
nonproprietary_name	string	通用名/INN名称
dosage_form	string	剂型（如 TABLET, CAPSULE）
route	string	给药途径（如 ORAL, INTRAVENOUS）
labeler_name	string	制造商或标签商
substance_name	string	活性药物成分
strength	string	剂量强度值
strength_unit	string	剂量单位（如 mg/mL）
pharm_classes	string	FDA药理学分类
dea_schedule	string	DEA管制物质表（CI-CV）
marketing_category	string	上市类别（如 NDA, ANDA）
application_number	string	FDA申请编号
start_date	string	上市开始日期
end_date	string	上市结束日期（null = 活跃中）
ndc_exclude_flag	string	Y = 从活跃目录中排除

包装实体 (ndc_package) 字段

字段	类型	描述
product_id	string	链接到父产品
product_ndc	string	父产品NDC
ndc_package_code	string	完整11位NDC（产品+包装段）
package_description	string	可读的包装描述
start_date	string	包装上市开始日期
end_date	string	包装上市结束日期
ndc_exclude_flag	string	Y = 排除
sample_package	boolean	true = 药品样品包装

NDC编码格式

• 完整11位NDC: 12345-6789-01（标签商段 (5位)-产品段 (4位)-包装段 (2位)）
• product_ndc：标签商+产品段，格式 12345-6789
• ndc_package_code：完整11位代码

DEA受控物质分类

计划	含义
CI	无公认医疗用途，高滥用潜力
CII	高滥用潜力，有公认医疗用途
CIII	中等滥用潜力
CIV	较低滥用潜力
CV	受控物质中滥用潜力最低

API主要端点与功能

• 多条件过滤产品列表 (GET /products)：按产品类型、标签商、活性物质、剂型、给药途径、DEA计划、上市类别筛选，支持活跃/排除切换和分页（最多500条/请求）。
• 按NDC查询产品 (GET /products/{ndc})：获取完整产品记录。
• 查询产品包装配置 (GET /products/{ndc}/packages)：检索所有相关包装（NDC包装代码、描述、样品标志）。
• 按包装代码查询 (GET /packages/{full_ndc})：通过完整11位NDC解析包装记录。
• 全文药物名称搜索 (GET /products/search?q=): 同时搜索品牌名和通用名，支持快速自动补全或目录查找。
• 统计分析：查询产品类型、剂型、DEA受控物质表的分布情况。

分页机制

• 端点 GET /products 支持 limit 和 offset 参数。
• 最大 limit 为 500，默认值为 50。
• active_only=true（默认）排除已停产品；active_only=false 包含已停产品。