Food Data API

Access 450k+ branded foods with ingredients, nutrition facts, and barcodes.

原始信息汇总

Food Data API 数据集概述

数据集基本信息

• 数据集名称：Food Data API
• 数据来源：USDA FoodData Central 数据库
• 数据规模：超过 450,000 种食品条目
• 当前版本：1.0.0
• API 主机：food-data-api.p.rapidapi.com

核心功能

• 全面搜索：支持对超过 45 万种食品进行全文搜索。
• 营养信息：提供超过 50 种营养素的详细数据，包括宏量营养素（脂肪、蛋白质、碳水化合物）和微量营养素（钙、纤维、维生素）。
• 条码查询：支持使用标准的 12-14 位条码（UPC-A, UPC-E, EAN-13, EAN-14）即时检索食品数据。
• 条码生成：提供生成 SVG 条码图像的端点。
• 智能筛选：支持按类别、品牌所有者或描述进行搜索。
• 分页支持：通过 continuation token 高效处理大型数据集。

适用场景

• 卡路里与宏量营养素追踪器：获取份量信息和全面的营养概况。
• 杂货与库存应用：扫描产品以检索元数据或生成货架标签。
• 膳食分析工具：根据成分和营养含量筛选食品。
• 食谱管理器：使用标准化的 USDA 描述规范成分数据。

端点详情

1. 获取类别

• 端点：GET /api/categories
• 描述：检索所有可用的食品类别。
• 响应示例： json { "categories": [ "Alcohol", "Alcoholic Beverages", "All Noodles", "Amino Acid Supplements" // ... 300+ 更多类别 ] }

2. 搜索食品

• 端点：GET /api/foods
• 描述：通过描述搜索食品，支持可选筛选。
• 查询参数：
  • q (string, 必需): 食品描述的搜索词。
  • limit (integer, 可选): 每页结果数（默认: 20，最大: 100）。
  • continuationToken (string, 可选): 用于分页的令牌。
  • category (string, 可选): 按类别筛选。
  • brand (string, 可选): 按品牌名称筛选。
• 分页：使用响应中的 continuationToken 获取下一页。

3. 通过 UPC 获取食品

• 端点：GET /api/foods/{upc}
• 描述：通过 UPC 条码检索特定食品的详细信息。
• 路径参数：
  • upc (string, 必需): 12-14 位 UPC 条码。
• 有效的 UPC 格式：
  • UPC-A: 12 位数字。
  • UPC-E: 8 位数字（填充至 12 位）。
  • EAN-13: 13 位数字。
  • EAN-14: 14 位数字。

4. 生成条码

• 端点：GET /api/foods/{upc}/barcode
• 描述：为 UPC 码生成 SVG 条码图像。
• 路径参数：
  • upc (string, 必需): 12-14 位 UPC 条码。
• 查询参数：
  • format (string, 可选): 条码格式（默认: upca）。
• 支持的条码格式：
  • upca: UPC-A (12 位数字)。
  • ean13: EAN-13 (13 位数字)。
  • code128: Code 128 (可变长度)。
• 响应：返回 Content-Type: image/svg+xml 的 SVG 图像。

数据模型

食品条目

字段	类型	描述
fdcId	integer	FoodData Central ID
description	string	食品描述/名称
brandOwner	string	null
gtinUpc	string	null
ingredients	string	null
servingSize	number	null
servingSizeUnit	string	null
householdServingFullText	string	null
foodNutrients	array	详细的营养素数组
brandedFoodCategory	string	null
publicationDate	string	null

营养素

字段	类型	描述
number	string	营养素编号
name	string	营养素名称
amount	number	营养素含量
unitName	string	计量单位

认证

通过 RapidAPI 使用时，所有请求需包含以下请求头：

• X-RapidAPI-Key: YOUR_API_KEY
• X-RapidAPI-Host: food-data-api.p.rapidapi.com

错误处理

所有错误均返回以下结构的 JSON 对象： json { "error": "错误信息", "message": "详细的错误描述" }

常见错误码：

• 400 Bad Request: 请求参数无效。
• 404 Not Found: 未找到资源。
• 429 Too Many Requests: 超出速率限制。
• 500 Internal Server Error: 服务器端错误。

速率限制

速率限制因定价层级而异：

层级	请求/天	请求/分钟
Free	100	10
Basic	10,000	100
Pro	100,000	500
Ultra	1,000,000	2,000

代码示例

提供了 JavaScript (Fetch API) 和 Python 的调用示例。

搜集汇总

背景与挑战

背景概述

该API提供超过45万种品牌食品数据，包含配料信息、营养成分表及对应条形码。