Food Product Barcode API: Nutrition & Allergens

Scan a barcode for product name, brand, ingredients, nutrition per 100g/serving and allergen/vegan/vegetarian flags, from Open Food Facts.

原始信息汇总

Food Product Barcode API: Nutrition & Allergens 数据集详情总结

数据集概述

本API提供Open Food Facts（以及其姊妹数据库Open Beauty Facts和Open Products Facts）的实时代理服务，用户可通过EAN/UPC条形码查询产品的身份信息、成分、营养事实及过敏原/膳食标签，也支持自由文本搜索产品。该API旨在为食品相关应用提供便捷的数据访问接口。

主要功能

• 条形码查询：通过GET /products/{barcode}端点，获取产品的身份、品牌、类别、标签、过敏原、Nutri-Score/NOVA/Eco-Score等信息。
• 营养信息查询：通过GET /products/{barcode}/nutrition端点，获取每100克及每份的营养成分数据（能量、脂肪、糖、盐等）。
• 过敏原查询：通过GET /products/{barcode}/allergens端点，获取过敏原/痕迹信息及衍生的棕榈油、素食和纯素标记。
• 产品搜索：通过GET /products/search端点，支持基于自由文本的产品搜索（仅限Open Food Facts数据库）。

应用场景

该API专为以下场景设计：

• 杂货和食谱应用开发。
• 饮食限制过滤（纯素/素食/过敏原）。
• 零售目录丰富化。
• 营养追踪工具。

数据来源与许可

• 数据来源：数据来自Open Food Facts（及作为后备的Open Beauty Facts / Open Products Facts），这些是开放协作数据库。
• 许可协议：数据在开放数据库许可（ODbL）1.0下提供。
• 归属要求：使用时需注明“© Open Food Facts contributors”。

数据局限性与性能说明

• 实时代理与缓存：该API为具有边缘缓存（产品查询和搜索的TTL分别为24小时和12小时）的实时代理，不提供SLA保证。
• 数据覆盖不完整：营养信息、过敏原标签、图像等字段的完整性完全取决于贡献者录入的数据，许多产品仅包含部分数据。
• 上游速率限制：搜索功能受Open Food Facts自身速率限制（约每分钟10次请求），12小时缓存可吸收重复查询，但对新的不同查询突发可能仍会被上游限制。

错误处理机制

API在发生错误时返回JSON格式的{"error": "<code>", "message": "<text>"}，并设置Cache-Control: no-store，具体错误码包括：

• INVALID_BARCODE（400）：条形码必须为8-14位数字。
• NOT_FOUND（404）：三个数据库中均未找到产品。
• UPSTREAM_UNAVAILABLE（503）：上游服务超时、出错或返回无效JSON。
• UPSTREAM_RATE_LIMITED（429）：上游速率受限。
• METHOD_NOT_ALLOWED（405）：仅支持GET方法。
• QUERY_TOO_LONG（414）：查询字符串超过512字符。

订阅方案

该API提供多个订阅层级，满足不同用户的需求：

• BASIC：$0.00/月
• PRO：$12.00/月
• ULTRA：$39.00/月
• MEGA：$99.00/月