USDA FoodData Central · 食品营养资料API

USDA FoodData Central官方REST API可按关键词搜索食品或按FDC ID取详情，需data.gov API key，数据按CC0公开。普通与DEMO key限额不同，超额可429。仅文档整理，未查询；完整响应结构、数据版本与运行可用性未验证。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：食品营养公开数据｜需data.gov密钥的搜索与详情API · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 938aa9d6a04fa6071a1e82bef110fc51d7730a094d7d26bfbbb9f6c62040322b

The USDA FoodData Central API provides assistance to application developers wishing to incorporate nutrient data into their applications or websites.

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-a3e445b08d876f8a44901dcd · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-a3e445b08d876f8a44901dcd
名片版本: 2
资料更新: 2026-10-24T18:19:26.4628649+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

/foods/search接query关键词，可选dataType数组、sortBy/sortOrder等，按具体schema使用。
/food/{fdcId}为GET单详情；/foods为GET/POST多ID；/foods/list为GET/POST分页列表。
示例pageSize与分类过滤存在，完整参数上限需OpenAPI细表，本页未展开。

输出

按关键词匹配的食品列表、单个或多食品详情及分页abridged列表，具体营养字段需对应data type文档。
当前指南没有完整响应样例/schema，不能推断每种食品都有同一组完整营养值。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: 未知

鉴权：API 密钥。每个请求api_key参数传data.gov API key；DEMO_KEY仅初步探索且限额很低，不是匿名无限服务。本轮未注册或使用任何key。

运行前提

data.gov API key及HTTP客户端；根据数据类型文档解释营养字段、单位和食品类别。
GET/POST按端点支持区分，POST使用application/json；本页包含公开示例但不执行。
不要把食品营养数据查询等同个体诊疗或饮食方案验证。

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。FDC数据明确public domain/CC0 1.0，无需许可并建议注明USDA FoodData Central来源；当前页没有API收费价格，仍需key及配额，不能把开放数据许可当无限服务承诺。

价格来源 · 未知

资料去向

提供者服务器。实际请求会发送食品查询词、ID和key，日志/留存未知。CC0适用于所述FDC数据，不能自动推广为第三方代码或用户提交数据许可。本轮未上传饮食、患者或个人资料。

限制

默认1000请求/小时/IP，超额可使key暂封1小时并429；需读X-RateLimit-Limit/Remaining。
DEMO_KEY仅30请求/小时和50请求/天/IP，不混同普通key额度。
旧USDA Food Composition API已停更，当前应使用FDC路径；文档引用年份不是现场release验证。
数据公开许可不保证每项最新、完整或适合特定健康用途。

仍需核对

实际响应schema、当前数据release、查询结果和认证未验证。
API计费、提高额度条件、服务SLA与日志留存未知。
未调用食品API、分析用户饮食或运行医学能力测试。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:18:38.2206891+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

API Guide | USDA FoodData Central · 公开记录 · 2026-10-24T18:18:38.2206891+00:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://fdc.nal.usda.gov/api-guide/",
  "final_url": "https://fdc.nal.usda.gov/api-guide/",
  "status_code": 200,
  "title": "API Guide | USDA FoodData Central",
  "description": "The USDA FoodData Central API provides assistance to application developers wishing to incorporate nutrient data into their applications or websites.",
  "checked_at": "2026-10-24T18:18:38.2206891\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-a3e445b08d876f8a44901dcd",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://fdc.nal.usda.gov/api-guide/"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。