Spoonacular

简介

Spoonacular 是全面的食品 API——食谱搜索、营养分析、膳食规划、食材替代和葡萄酒搭配——免费层令人印象深刻（无效密钥返回 401，已实测）。是可用的最丰富的食品数据 API 之一。

快速开始

随机食谱（替换 YOUR_KEY）：

curl "https://api.spoonacular.com/recipes/random?apiKey=YOUR_KEY&number=1"

搜索食谱：

curl "https://api.spoonacular.com/recipes/complexSearch?apiKey=YOUR_KEY&query=pasta&number=5"

获取食谱的食材：

curl "https://api.spoonacular.com/recipes/716429/ingredientWidget.json?apiKey=YOUR_KEY"

按文本分析营养：

curl "https://api.spoonacular.com/recipes/visualizeNutrition?apiKey=YOUR_KEY" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "text=1%20cup%20rice%20with%202%20eggs"

认证方式

• 在 spoonacular.com 注册（免费）→ API 密钥在控制台。
• 通过 apiKey 查询参数携带（无效密钥返回 401——已实测）。

速率限制与注意事项

• 免费层：150 次请求/天（约 150 积分/天）——额度适中；付费档可扩展。
• 端点分组：食谱（搜索、随机、步骤）、食材（解析、替代）、菜单项、葡萄酒搭配、膳食规划。
• 丰富数据：nutrition、ingredients、instructions、sourceUrl、image 和 diets/cuisines 标记。
• 所有响应是 JSON；部分可视化端点返回图片。

常见问题

Spoonacular 免费吗？ 免费层：150 次/天；更多需要付费。

如何获取密钥？ 在 spoonacular.com 注册——密钥在控制台。

可以用它做什么？ 食谱搜索、营养分析、膳食规划器和购物清单生成器。