所有文章 > 学习各类API > 如何获取 USDA 美国农业部食物成分数据服务平台 API 密钥 (分步指南)
如何获取 USDA 美国农业部食物成分数据服务平台 API 密钥 (分步指南)

如何获取 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的替代品有哪些?

市场上存在免费、付费两种替代者

例如

openfoodfacts-全球食品透明数据库

Nutritics-食品数据管理软件

CHOMP-食品与营养数据库API

Edamam-食品数据库API,营养API和食谱API

更多竞品可以在USDA 美国农业部食物成分数据服务平台找到。

7. 总结

本文总结了USDA美国农业部食物成分数据服务平台API的申请、密钥可用性测试及实际调用方法,并通过示例展示了获取食品营养数据的完整过程。同时介绍了在搭建应用时需要注意的关键因素,如API密钥的使用方式、请求速率限制及数据格式兼容性,并对常见问题与替代方案进行了梳理。最后,还提供了进阶使用指引和参考案例,帮助开发者更高效地利用该平台集成营养数据,支持科研与应用开发。

#你可能也喜欢这些API文章!

我们有何不同?

API服务商零注册

多API并行试用

数据驱动选型,提升决策效率

查看全部API→
🔥

热门场景实测,选对API

#AI文本生成大模型API

对比大模型API的内容创意新颖性、情感共鸣力、商业转化潜力

25个渠道
一键对比试用API 限时免费

#AI深度推理大模型API

对比大模型API的逻辑推理准确性、分析深度、可视化建议合理性

10个渠道
一键对比试用API 限时免费