如何获取 USDA 美国农业部食物成分数据服务平台 API 密钥 (分步指南)
文章目录
在营养健康与食品科学研究领域，快速获取权威的食物成分数据至关重要。USDA 食物成分数据服务平台 API 为开发者和研究人员提供了强大的工具，能够方便地访问数百万条食品营养信息，包括能量、宏量营养素、微量元素及相关数据。通过使用该 API，用户可以实现对食物成分的实时查询与整合，为营养分析、饮食推荐和食品应用提供精准的数据支持。本文将指导你如何获取 USDA 食物成分数据服务平台 API 密钥，并进行初步的可用性测试，同时探讨在使用过程中需要注意的关键因素。
1. 获取USDA 美国农业部食物成分数据服务平台API密钥步骤
获取USDA 美国农业部食物成分数据服务平台API密钥的过程相对简单，只需几个步骤即可完成：
1.访问 幂简平台中 USDA 美国农业部食物成分数据服务平台 服务商：
点击右侧访问官网
2.点击官网顶部导航栏中 数据->获取API密钥。
3.在这里填写自己的邮箱（注意：邮箱不要填错，用来接收密钥）
4.填写完以后官网会往你的邮箱里发送密钥，去邮箱中查看。
5.在邮箱中可以看到已经成功获取到密钥了。
2. USDA 美国农业部食物成分数据服务平台 API密钥可用性测试
在获取API密钥后，进行可用性测试是确保其正常工作的重要步骤。以下是使用curl进行测试的一个案例
以下接口为USDA 美国农业部食物成分数据服务平台 接口中 获取单个食品项的详细信息（通过 FDC ID） 接口。
输入：
curl --location --request GET 'https://api.nal.usda.gov/fdc/v1/food/1750340?api_key=JYoAXa8S6tmbXjbN0pdJLMcXOVwEnJsKlanCUFY7'
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)'
--header 'Accept: */*'
--header 'Host: api.nal.usda.gov'
--header 'Connection: keep-alive'输出：
结果以 JSON 格式返回，内容包含食物营养数据的完整信息，包括基础元数据（食品ID、描述及发布日期）、营养素信息（营养素ID、编号、名称、单位及分类）、测定来源与方法（数据来源、分析方式、实验室技术及参考文献链接），以及具体的营养测定结果（含量、数据点数量、最大值、最小值、中位数及采样年份），同时附带样本采集细节（购买时间、地点及包装商信息）；全面展示了该食品的营养成分结构与分析过程，便于研究者和开发者快速获取和利用营养学相关数据。
{
"fdcId": 1750340,
"description": "Apples, fuji, with skin, raw",
"publicationDate": "10/30/2020",
"foodNutrients": [
{
"nutrient": {
"id": 2045,
"number": "951",
"name": "Proximates",
"rank": 50,
"unitName": "g"
},
"type": "FoodNutrient"
},
{
"type": "FoodNutrient",
"nutrient": {
"id": 1051,
"number": "255",
"name": "Water",
"rank": 100,
"unitName": "g"
},
"foodNutrientDerivation": {
"id": 1,
"code": "A",
"description": "Analytical",
"foodNutrientSource": {
"id": 1,
"code": "1",
"description": "Analytical or derived from analytical"
}
},
"id": 21115472,
"amount": 83.61000000,
"dataPoints": 8,
"max": 84.67000000,
"min": 82.04000000,
"median": 83.75000000,
"minYearAcquired": 2020,
"nutrientAnalysisDetails": [
{
"subSampleId": 1752858,
"nutrientId": 1051,
"nutrientAcquisitionDetails": [
{
"sampleUnitId": 1750427,
"purchaseDate": "4/16/2020",
"storeCity": "Blacksburg",
"storeState": "VA",
"packerCity": "Cincinnati",
"packerState": "OH"
}
],
"amount": 82.04,
"labMethodTechnique": "Vacuum oven",
"labMethodDescription": "AOAC 934.06 mod",
"labMethodOriginalDescription": "AOAC 934.06 (37.1.10) Moisture in Fruits, Vegetables, and their Products",
"labMethodLink": "https://doi.org/10.1093/9780197610145.001.0001"
},
{
"subSampleId": 1752889,
"nutrientId": 1051,
"nutrientAcquisitionDetails": [
{
"sampleUnitId": 1750429,
"purchaseDate": "4/20/2020",
"storeCity": "Burtonsville",
"storeState": "MD",
"packerCity": "Landover",
"packerState": "MD"
}
],
"amount": 83.745,
"labMethodTechnique": "Vacuum oven",
"labMethodDescription": "AOAC 934.06 mod",
"labMethodOriginalDescription": "AOAC 934.06 (37.1.10) Moisture in Fruits, Vegetables, and their Products",
"labMethodLink": "https://doi.org/10.1093/9780197610145.001.0001"
},
{
"subSampleId": 1752902,
"nutrientId": 1051,
"nutrientAcquisitionDetails": [
{
"sampleUnitId": 1750431,
"purchaseDate": "4/20/2020",
"storeCity": "Burtonsville",
"storeState": "MD",
"packerCity": "Landover",
"packerState": "MD"
}
],
"amount": 83.2,
"labMethodTechnique": "Vacuum oven",
"labMethodDescription": "AOAC 934.06 mod",
"labMethodOriginalDescription": "AOAC 934.06 (37.1.10) Moisture in Fruits, Vegetables, and their Products",
"labMethodLink": "https://doi.org/10.1093/9780197610145.001.0001"
}
......
}3. 使用USDA 美国农业部食物成分数据服务平台API搭建应用的其他关键考虑因素
在使用USDA 美国农业部食物成分数据服务平台API搭建应用时，除了获取和测试API密钥外，还需考虑以下因素：
API 密钥
任何人都可以访问和使用 API。但是，每个 API 请求都必须包含一个 data.gov API 密钥。请注册以获取密钥 ，然后按照如何使用密钥的说明进行操作。
如何使用 API 密钥
在请求地址后面拼接&apikey=DEMOKEY
速率限制
FoodData Central 目前限制 API 请求数量，每个 IP 地址每小时默认为 1,000 次请求，这对大多数应用来说已经足够。超过此限制将导致 API 密钥被暂时封锁 1 小时。
4. USDA 美国农业部食物成分数据服务平台API密钥申请和使用中的常见问题
在申请和使用 USDA 美国农业部食物成分数据服务平台API密钥过程中，你可能会遇到以下常见问题：
FoodData Central 是否可以通过 API 访问？
是的。FoodData Central 提供 API，开发者可以将营养数据集成到应用或网站中。旧版 USDA 食品成分数据库的 API 已于 2020 年 3 月停止服务，用户需要改用 FoodData Central 提供的新 API，并通过申请 API 密钥来调用。
FoodData Central API 提供哪些数据类型？
API 涵盖多种数据类型，包括基础食品（Foundation Foods）、实验性食品（Experimental Foods）、国家营养标准参考数据库（SR Legacy）、膳食研究与营养数据库（FNDDS 2021-2023）以及 USDA 全球品牌食品数据库（Branded Foods）。开发者可根据研究或应用场景选择相应的数据类型。
使用 FoodData Central API 能否获取最新更新的数据？
可以。Branded Foods 数据会通过 API 每月更新；Foundation Foods 和 Experimental Foods 会在每次新版本发布时更新；FNDDS 与 NHANES 调查同步，每两年更新一次。API 始终提供最新的营养和食品数据。
使用 FoodData Central API 是否需要注意兼容性？
需要注意。API 支持 JSON 和 CSV 格式的数据下载，适合与不同系统对接。同时，部分旧版数据库（如 SR Legacy）不再更新，仅保留历史数据，开发者在使用时应优先选择 Foundation Foods 等动态更新的数据类型，以确保信息的时效性。
5. USDA 美国农业部食物成分数据服务平台API进阶指引
在获得USDA 美国农业部食物成分数据服务平台API密钥之后，即可开启API接口对接，本文整理了多篇使用USDA 美国农业部食物成分数据服务平台API的案例，帮助读者更有效地使用USDA 美国农业部食物成分数据服务平台API：
获取单个食品项的详细信息、使用输入的 FDC IDs 获取多个食品项的详细信息、以’精简’格式返回分页的食品列表、返回与搜索（查询）关键字匹配的食物列表
6. 常见问题
问题1： 什么是幂简集成平台？
幂简集成是蜜堂有信在2023年打造的一款SAAS产品，建设着国内最全的API平台，为开发者提供全面、高效、易用的API集成管理方案，一站搜索、试用、集成国内和国外API。让用户在AI时代全方位接入互联网，用API连接一切服务和算力，实现价值倍增。
问题2：如何找到USDA 美国农业部食物成分数据服务平台API
幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’USDA 美国农业部食物成分数据服务平台API‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。
问题3：USDA 美国农业部食物成分数据服务平台API的替代品有哪些？
市场上存在免费、付费两种替代者
例如
更多竞品可以在USDA 美国农业部食物成分数据服务平台找到。
7. 总结
本文总结了USDA美国农业部食物成分数据服务平台API的申请、密钥可用性测试及实际调用方法，并通过示例展示了获取食品营养数据的完整过程。同时介绍了在搭建应用时需要注意的关键因素，如API密钥的使用方式、请求速率限制及数据格式兼容性，并对常见问题与替代方案进行了梳理。最后，还提供了进阶使用指引和参考案例，帮助开发者更高效地利用该平台集成营养数据，支持科研与应用开发。