为什么团队选择 Tuduu API
立足欧洲的营养与食品科技基础设施，助力业务更快走向国际市场。
原生多语言
支持 17 种语言的营养分析与食谱匹配，无需中间翻译。推出新语言大约只需一周。
算法架构
无需维护静态食品数据库。专有模型可快速适应不同零售商、市场和本地化食品目录。
完整技术栈
涵盖营养、食谱和零售增强的三个集成模块。一个供应商，一个集成界面。
常见问题
Nutrition API 是提供营养智能即服务的全球 SaaS 平台。
不同于返回静态数值的传统营养数据库，Nutrition API 使用 4 种专有算法，动态计算营养评分、用户与产品的兼容性、食谱分析和个性化膳食计划。
该服务支持 17 种语言，采用预付费使用模式，每次调用的起始费用为 0.01 欧元，并提供按四个阶段组织的 40 多个 API 端点。
Nutrition API 是一家总部位于米兰的 100% 欧洲企业，原生符合 GDPR，并遵循欧盟第 1169/2011 号法规。
在 nutrition-api.com 注册，获取 API 密钥，然后开始集成。
Nutrition API 采用预付费、按使用量计费的 SaaS 模式。
1 个积分 = 0.01 欧元，每次 API 调用消耗的积分数量会根据服务复杂度而有所不同。
按照为支持业务增长而设计的不同套餐层级，积分单价会随用量增加而降低。
使用 Nutrition API，你在套餐额度内只需为实际使用的服务付费：无需设置费，也没有最低承诺。
Nutrition API 并不是一个通过 API 提供服务的简单营养数据库，而是一个不同的平台类别。
五项核心差异如下：
1. 专有算法：实时计算结果，而不是静态的第三方数据集。
2. 原生多语言引擎：所有端点集成支持 17 种语言。
3. 零售媒体层：基于食谱食材提供赞助商品 API。
4. 按使用量计费的 SaaS 模式：采用预付费积分，而不是固定月度订阅。
5. 100% 欧洲布局：总部位于米兰，原生符合 GDPR，并遵循欧盟第 1169/2011 号法规。
凡是需要计算、分析或应用营养数据的场景，应用可能性几乎没有限制。
当前场景包括：
- 杂货与零售：自动化标签、食谱目录、零售媒体和营养忠诚度计划。
- 餐饮服务与 HoReCa：菜单设计、过敏原合规和季节性 AI 食谱。
- 药房与营养保健品：营养建议及补充剂工作流。
- 健康与健身：个性化计划、宏量和微量营养素跟踪，以及 AI 指导。
- 食品科技与应用：白标后端能力。
- 保险与 InsurTech：面向健康产品的营养评分。
- 教育与媒体：多语言学习与内容平台。
模块化架构让跨行业适配变得简单直接。
几天，而不是几个月。
典型的上手流程分为三步：
1. 自助注册：在 nutrition-api.com 创建账户，立即获得沙盒和 API 密钥访问权限。
2. 免费测试：使用真实数据验证基础设施 API。
3. 按需扩展：充值积分并启用分析、评分和 AI API。
完整文档、代码示例和测试端点均可在线获取，并提供专属技术支持。
无需预先签订合同，也没有强制销售电话。
我们的 API
面向生产环境的端点，已被医疗服务提供商、食品电商平台和忠诚度产品采用。
Get food compatibility
GET
实时计算单个食物的营养兼容性，使用搜索接口返回的（source，id）组合定位。通过 Definitions 接口解码 flagId 和 outcomeId。 可断言的内容取决于目录：通用食物只有名称，因此只能针对饮食和过敏原标记返回结果，不能针对有机或清真等标签声明返回结果。包装商品则根据其标签进行分析，也能针对这些声明返回结果。 仅支持意大利语：对于任何其他 Accept-Language，都会返回 406。
Get food macronutrients and portion
GET
获取单个食物每 100 克的宏量营养素和份量，使用搜索接口返回的（source，id）组合定位。可用于重新显示日记中已经保存的食物，无需再次搜索。 仅支持意大利语：对于任何其他 Accept-Language，都会返回 406。
Search foods by name
POST
按照饮食日记用户输入食物的方式搜索食物。结果混合来自两个目录的内容：通用食物（“香蕉”、“全脂牛奶”），这些通常就是日记条目所指的内容；以及 Tuduu 主目录中的包装商品。每个结果都已附带每 100 克的宏量营养素和份量，因此展示搜索结果无需再次调用接口。 每页包含 15 个项目，页面大小不可配置。当查询匹配到任意内容时，前 5 个通用食物最多会出现在第一页；第一页中其余的项目以及后续每一页的所有项目都来自包装商品目录。 要继续滚动，请回传你收到的“meta.nextCursor”，无需提供“searchText”：游标已经携带查询条件；如果两者都发送，游标优先。“nextCursor”为 null 表示没有更多结果。滚动会在前 1000 个包装商品后停止；如需查找更靠后的结果，请细化查询。 匹配会容忍重音符号、单复数和额外修饰词：“caffè zuccherato”会返回咖啡，而不是空列表。只返回已知热量的食物；包装商品结果仅限可食用类别以及声明了品牌的产品，因为仅由名称描述的产品无法与其重复项区分；这些产品仍可通过 id 访问。声明了份量的包装商品结果优先显示。 仅支持意大利语：对于任何其他 Accept-Language，此接口都会返回 406，因为通用食物名称仅提供意大利语。
Generate purchasable product matches from a shopping list
POST
将任何购物清单，包括手写笔记、语音备忘录或复制的文本，转换为实时电子商务购物车，并填入你商店库存中的商品。支持智能多零售商匹配、智能替代品和数量优化。这是一种独特解决方案，目前没有竞争对手能为真实商品目录提供同类能力。 使用场景： 杂货与在线零售 • 顾客将购物清单粘贴到应用中 → 一键使用真实商品目录中的产品填满购物车。基于实际目录进行智能匹配。 健康与保健应用 • 应用生成每周饮食清单 → “在合作超市全部购买”按钮将其转换为真实购物车。 餐厅与餐饮服务 • 餐厅提供可在家复制的配方：顾客按下“购买食材”，即可获得一个填入合作超市商品的购物车。 餐包与配送 • 提供“在离你最近的超市购买食材”，作为预包装餐包的替代方案。API 将食材映射到本地商店。 语音助手与聊天机器人 • 用户说“添加牛奶、面包和马苏里拉奶酪”。API 解读自然语言文本，并匹配真实商品。
Products compatibility analysis
POST
验证包装食品是否适合特定个人资料。分析食材、营养成分、包装数据和标签。根据“可能含有……微量成分”的声明，包含交叉污染标记。这是构建智能食品电子商务目录的基础组件。 使用场景： 杂货——目录 enriquecimiento • 验证电子商务目录中的每件商品：“适合纯素食者吗？”API 会针对每个生活方式标记返回兼容性结果，可通过 Definitions 端点解析。 带条形码扫描器的购物应用 • 用户在超市扫描条形码后，立即查看商品是否符合其个人资料。 制药——单品检查 • 药剂师或患者验证食品是否适合特定治疗性饮食，例如肾脏病饮食或苯丙酮尿症饮食。
Get product compatibility
GET
根据由 Tuduu 内部标识符标识的商品标签，实时计算营养兼容性。请通过 Definitions 端点解析 flagId 和 outcomeId。 仅支持意大利语：由于主目录存储的是意大利语数据，对于任何其他 Accept-Language，此端点都会返回 406。
Get product macronutrients
GET
获取由 Tuduu 内部标识符标识的商品每 100 克所声明的宏量营养素。 仅支持意大利语：由于主目录存储的是意大利语数据，对于任何其他 Accept-Language，此端点都会返回 406。
Resolve a product by EAN
GET
根据 EAN 解析包装食品商品，并获取其 Tuduu 内部标识符、标题、品牌、食材和标签格式。 仅支持意大利语：由于主目录存储的是意大利语数据，对于任何其他 Accept-Language，此端点都会返回 406。
Search products by name
POST
按商品名称搜索 Tuduu 主目录中的包装商品，并使用意大利全文搜索进行排序。返回完整目录中的所有商品，包括可食用和不可食用商品，并公开其他商品端点所接受的 Tuduu 内部标识符。 食材信息并不总是已知：对于我们尚未采集标签信息的商品，其“ingredients”字段为 null，但这些商品仍可正常搜索。若要搜索用于饮食记录的食品，并包含通用食品和营养素，请改用 Foods 端点。 仅支持意大利语：由于主目录存储的是意大利语数据，对于任何其他 Accept-Language，此端点都会返回 406。
Recipes compatibility analysis
POST
即时验证配方是否符合特定饮食档案。通过专有确定性算法实现毫秒级响应，而非概率型人工智能。相同配方始终得到相同结果。可追溯、可审计、可重复。市场上唯一独立的配方兼容性服务。 使用场景： 烹饪应用 — 自动徽章 • 在每个配方上显示“适合纯素者”或“不适合：含有鸡蛋”等徽章。自动、可靠、实时。无需依赖不可靠的手动标签。 美食博主与内容创作者 • 发布前自动验证：标记为无麸质的配方是否真的无麸质？ 企业与学校食堂 • 快速检查特定菜肴是否适合有饮食限制的学生或员工。 餐厅 • 在为有特定饮食需求的顾客上菜前，验证菜肴是否适合。
Recipe macronutrients analysis
POST
为任何食谱计算 5 项关键宏量营养素：热量、蛋白质、碳水化合物、脂肪和膳食纤维。结果同时按最终食谱每 100 克和每份返回（每份数据根据输入的份数计算）。食材级数值也采用相同的双重计量基准。食谱级响应还包括脂肪、碳水化合物和蛋白质的能量分布，使用 Atwater 系数计算（脂肪 × 9、碳水化合物 × 4、蛋白质 × 4）。专有确定性算法。同一食谱始终得到相同结果。支持回溯测试、审计，并已根据 IEO（欧洲肿瘤研究所）数据库完成验证。 使用场景： 食谱平台 — 自动营养成分表 • 在每个食谱下显示每份营养价值。支持 SEO 营养富摘要。 健身和营养跟踪应用 • 用户输入自制食谱，即可获得精确数值，而不是通用数据库估算值。 餐厅 — 带营养价值的菜单 • 自动计算每道菜单菜品的宏量营养素，满足日益增长的营养透明度需求。 制药 — 膳食计划验证 • 自动验证治疗性膳食计划中食谱的营养价值。
Generate purchasable product matches from recipe ingredients
POST
将完整食谱转换为可直接购买的电子商务购物车。智能解析食材、计算每份用量、去重，并与真实零售商目录中的商品进行匹配。每个食谱网站都应该有的“购买食材”按钮。 必须拥有已同步的商品目录。 使用场景： 包含编辑内容的食品电子商务 • 电子商务博客中的每个食谱都变成可购买的落地页。客户阅读食谱，点击“将所有食材加入购物车”，购物车即刻准备就绪。博客成为销售渠道。 烹饪应用和食谱平台 • 通过零售合作伙伴关系将食谱数据库变现。用户选择食谱，再选择超市，即可获得准备好的购物车。 餐厅和美食博主 • 每个已发布食谱下方都有“购买这些食材”链接。结合饮食个性化功能实现智能联盟营销（套装 6 和完整版变体）。 个性化餐包 • 客户选择每周食谱 → API 通过去除多个食谱中的重复食材来生成优化购物车。
Get a recipe
GET
通过标识符获取特定食谱的完整深度详情。包括步骤、食材、营养值和媒体内容，为在你的平台上呈现丰富的互动烹饪体验提供所需的一切。专为极速获取而打造，为你的应用提供主要食谱详情页面的支持。 使用场景： 互动烹饪模式 • 在你的应用中提供分步骤、无干扰的烹饪模式，包含精确的时间、说明和媒体资源。可与语音助手集成。 电子商务——增强型商品页面 • 在以某种食材为关键组成部分的商品页面中嵌入完整食谱。用户可从食谱视图将所有食材加入购物车。 餐厅——互动数字菜单 • 顾客扫描菜品二维码后即可查看完整食谱：食材、准备方法和营养值。 食品配送套装 • 为实体餐食套装提供数字说明手册。顾客扫描盒子上的二维码后即可查看分步骤食谱。
Get ingredient sponsored products for a recipe
GET
获取明确关联到特定食谱食材的所有赞助商品。通过定位单个食谱，你可以立即确定用户查看该菜品时应原生展示哪些品牌商品。精准安排零售媒体展示的理想工具。 使用场景： 上下文商品展示 • 用户查看“经典提拉米苏”食谱 → “品牌 Y 马斯卡彭奶酪”作为赞助推荐出现在食材列表旁边。在购买意愿达到峰值时实现高转化。 餐厅——供应商合作 • 餐厅在数字菜单中将供应商商品展示在食谱食材旁边。通过供应商获得广告收入。 一键“购买食谱所需食材” • 使用后台配置的赞助商品为“全部加入购物车”按钮提供支持。打造与食谱匹配且可盈利的购物车。
Get suggestion sponsored products for a recipe
GET
获取与特定食谱关联的所有赞助工具、搭配商品或建议。这样你可以使用高质量、精准定位的交叉销售内容丰富食谱详情页，例如厨房电器或饮品搭配，并且完全针对用户当前查看的菜品进行定制。 使用场景： 厨具交叉销售 • “炖牛肉”食谱展示赞助铸铁荷兰锅或合作品牌厨师刀。扩大食品之外的购物车内容。 葡萄酒与饮品搭配 • 在食谱页面设置“与这道菜完美搭配”区域，展示赞助葡萄酒、精酿啤酒或软饮料。 餐厅——互补推荐 • 数字菜单为选定菜品推荐搭配葡萄酒或理想甜点。基于上下文进行追加销售。 生活方式与呈现 • 推荐赞助餐具、餐巾和主题装饰，例如浪漫晚餐或夏日烧烤主题装饰。
Browse recipes
POST
获取经过身份验证的商店账户可用的完整分页食谱目录。你可以按类型、发布状态和软删除状态筛选食谱，从而准确获取平台所需的烹饪内容。此端点是无头食谱 CMS 体验的核心，让你能够构建动态且引人入胜的食品相关应用，而无需承担内容创建工作。 使用场景： 电子商务和店面 • 使用专业烹饪内容填充电子商务中的“食谱”或“灵感”版块。按季节或当前促销活动筛选。 营养和饮食应用 • 获取按类型（纯素、生酮、高蛋白）分类的批量食谱，为内部推荐引擎提供内容。 餐厅和餐饮服务 • 通过餐桌上的二维码或在线菜单，为客户提供可浏览的数字季节性食谱目录。 数字杂志和美食博客 • 自动使用结构化的专业食谱内容填充美食博客或生活方式应用。
Browse recipes matching all given ingredients (What's in my fridge?)
POST
输入你家中现有的食材，发现所有可以制作的食谱，并按匹配百分比排序。如果只缺少一种食材，API 会标记出来并建议替代品。对抗食物浪费的终极利器：用你已有的食材烹饪，而不是购买那些“按理说应该”购买的东西。 使用场景： 减少食物浪费的应用 • “我有鸡肉、西葫芦、大米和帕尔马干酪”——API 返回可行食谱，并按匹配百分比排序。 消费者健康平台 • 将“冰箱里有什么”与“根据你的个人资料应该吃什么”结合起来：使用现有食材制作适合你的食谱。 餐厅——剩余食材管理 • 一天结束时，餐厅输入现有食材，获取每日特色菜建议。
List sponsored products for recipe ingredients
POST
获取分页平面列表，将食谱食材直接关联到目录中的赞助商品。此端点通过无缝地将通用食材（例如“橄榄油”“意大利面”）与具体的、可变现的品牌商品或自有品牌商品进行匹配，把普通食谱转化为强大的零售媒体资产。 使用场景： 零售媒体和变现 • 在购物清单视图中动态地用高端品牌替换通用食材。“番茄酱”变成“品牌 X 有机番茄酱”这一赞助建议。为零售商开辟新的收入渠道。 电子商务 — 追加销售 • 用户查看食谱食材时，优先展示高利润的自有品牌商品。提高平均购物篮金额。 智能购物清单 • 用户将食谱加入数字购物车时，自动使用准确的赞助 SKU 填充清单，减少从灵感到购买过程中的阻力。
List sponsored products for recipe suggestions
POST
获取分页列表，将食谱建议（例如厨房工具、葡萄酒搭配或上菜配件）与具体赞助商品关联起来。这超越了核心食材，从更广泛的烹饪和用餐体验中发掘机会，以最大限度地提高情境化交叉销售机会。 使用场景： 厨具交叉销售 — 汇总视图 • 商品管理人员仪表板：查看所有启用的用具与食谱搭配。大规模管理厨具展示位。 饮料搭配 — 目录管理 • 葡萄酒经理批量管理食谱与饮料参考之间的赞助搭配。 生活方式和配件 • 为餐具和装饰品提供赞助建议，并可从零售商后台批量管理。
Get countries
GET
API 集成 — 参考数据查询 • 获取所有受支持国家及其 ID 的完整列表，用于在集成中填充下拉菜单、筛选器和映射。 本地化 • 将其他 API 返回的 CountryIds 映射为用户语言显示的本地化国家名称。
Get difficulty levels
GET
烹饪应用 — 难度筛选器 • 使用用户的语言为“难度”筛选器填充正确值。用户搜索“简单食谱”时可获得一致的结果。 餐厅 — 基于难度等级的菜单 • 按准备难度对数字菜单中的食谱进行分类（适用于烹饪课程或 DIY 套件）。
Get Italian regions
GET
配方平台 — 区域筛选 • “坎帕尼亚配方”、“托斯卡纳特色菜”：由此 API 提供支持的区域筛选。按照烹饪传统组织编辑内容。 美食与葡萄酒旅游 • 旅游应用推荐所访问地区的典型配方。
Get lifestyle flags
GET
兼容性集成 — 标签映射 • 将 Compat API 返回的标记映射到应用界面中的正确名称和图标。这对于让用户理解兼容性结果至关重要。 电子商务 — 产品徽章 • 在产品卡片上为每个生活方式标记关联图形徽章（图标加颜色）。
Get measure units
GET
API 集成 — 单位转换 • 将配方和营养素 API 返回的 MeasureUnitId 解析为可读单位（g、ml、tablespoons、cups）。
Get outcome types
GET
兼容性集成 — 结果解读 • 将结果代码转换为用户易懂的消息：“适合 ✓”、“不适合：含有麸质 ✗”、“警告：可能含有微量成分 ⚠”。 医疗保健 — 合规报告 • 使用正式结果标签生成符合性报告，用于审计和临床文档。
Get recipe types
GET
烹饪应用 — 类型筛选 • 使用用户的语言，以正确的值填充“前菜”、“主菜”、“甜点”、“配菜”筛选器。 配方内容管理系统 — 分类 • 按类型组织配方目录，为用户创建易于浏览的分区。
Get supported languages
GET
API 集成 — 语言选择 • 使用 API 实际支持的语言填充应用的语言选择器。避免使用无效语言代码导致请求错误。 国际化平台 • 在请求翻译或本地化内容前，动态验证可用的语言。
为开发者打造
简洁易用的 REST API、交互式文档和快速上手流程。
快速响应
平均响应时间约为 200 毫秒，并提供 99.9% 的正常运行时间 SLA。
文档
交互式文档、代码示例，以及适用于 Python、JavaScript 和 PHP 的开箱即用 SDK。
5 分钟完成设置
简单的基于请求头的身份验证，让你快速从 API 密钥发出第一个请求。
专属支持
默认提供电子邮件支持，企业团队还可使用 Slack 工作流。