如何掌握USDA食品数据API分页获取完整营养信息

USDA食品数据API是美国农业部提供的公开食品营养数据库接口，开发者可以通过该接口获取各类食品的营养成分、含量等详细信息。不过该API默认单次请求返回的数据条数有限，当需要获取大量或者全量食品营养信息时，就必须使用分页机制来逐页拉取数据。

USDA食品数据API分页基础规则

USDA食品数据API的分页主要通过两个核心参数控制，分别是pageSize和pageNumber。pageSize用来设置单次请求返回的数据条数，取值范围通常在1到200之间，默认值为50。pageNumber用来指定当前请求的页码，从1开始计数。

每次请求的返回结果中会包含两个重要的分页相关字段：totalPages表示符合条件的总页数，totalHits表示符合条件的总数据条数。我们可以通过这两个字段判断是否需要继续请求下一页数据。

分页请求的核心实现步骤

1. 构造基础请求参数

首先需要准备好API的基础请求参数，包括API密钥、查询关键词、分页参数等。API密钥需要提前在USDA官网申请获取，查询关键词可以根据需要设置，比如查询所有水果类食品。

2. 循环发送分页请求

从第一页开始发送请求，每次请求后判断当前页码是否小于总页数，如果是则页码加1继续请求，直到获取完所有页的数据。

3. 整合所有页的数据

将每一页返回的食品营养数据整合到一个集合中，最终得到完整的营养信息列表。

完整代码示例（Python实现）

以下是使用Python语言实现USDA食品数据API分页获取完整营养信息的完整代码：

import requests

# 配置参数
API_KEY = "你的API密钥"
BASE_URL = "https://api.nal.usda.gov/fdc/v1/foods/search"
QUERY_KEYWORD = "apple"  # 查询关键词，可自定义
PAGE_SIZE = 100  # 单次请求返回条数，最大200

def fetch_all_nutrition_data():
    all_foods = []  # 存储所有食品数据
    page_number = 1  # 起始页码
    total_pages = None  # 总页数，初始为None

    while True:
        # 构造请求参数
        params = {
            "api_key": API_KEY,
            "query": QUERY_KEYWORD,
            "pageSize": PAGE_SIZE,
            "pageNumber": page_number
        }

        try:
            # 发送请求
            response = requests.get(BASE_URL, params=params)
            response.raise_for_status()  # 检查请求是否成功
            result = response.json()

            # 第一次请求时获取总页数
            if total_pages is None:
                total_pages = result.get("totalPages", 0)
                print(f"总页数：{total_pages}，总数据条数：{result.get('totalHits', 0)}")

            # 获取当前页的食品数据
            current_foods = result.get("foods", [])
            if not current_foods:
                print(f"第{page_number}页无数据，停止请求")
                break

            # 整合数据
            all_foods.extend(current_foods)
            print(f"已获取第{page_number}页数据，累计{len(all_foods)}条")

            # 判断是否还有下一页
            if page_number >= total_pages:
                break
            page_number += 1

        except requests.exceptions.RequestException as e:
            print(f"第{page_number}页请求失败：{e}")
            break

    return all_foods

if __name__ == "__main__":
    all_data = fetch_all_nutrition_data()
    print(f"最终获取到的完整营养信息总条数：{len(all_data)}")
    # 可以后续对all_data进行存储或处理

注意事项与异常处理

• API密钥需要妥善保管，不要硬编码在公开代码中，建议使用环境变量或者配置文件存储。
• 单次请求的频率不要过高，避免触发API的限流机制，可以在请求之间添加适当的延迟。
• 需要处理网络异常、返回数据格式异常等情况，避免程序中途崩溃。
• 如果查询条件返回的总数据量非常大，需要评估是否需要全量获取，避免不必要的请求消耗。

数据字段说明

返回的食品数据中，核心的营养信息字段如下：

通过上述方法，就可以完整获取USDA食品数据API中符合条件的所有营养信息，满足后续的数据分析、应用开发等需求。

USDA_Food_Data_APIpagination营养信息获取API请求数据处理修改时间：2026-06-12 13:18:26