Atlas / Categories / Food & Drink / Spoonacular Food & Drink — entry 012 of 20
Spoonacular Verified Jul 2026
Spoonacular is a broad food platform covering recipe search, ingredient parsing, meal planning, grocery product data, and wine pairing, backed by a database of hundreds of thousands of recipes, with a limited daily point allowance on its free tier before usage-based paid plans apply. A live GET against the real gateway, api.spoonacular.com, returned a genuine 401 'not authorized' JSON error while carrying an echoed Access-Control-Allow-Origin header, resolving cors unknown -> yes and reconfirming API Key auth in the same probe.
recipes meal-planning nutrition grocery
Authentication API Key Sign up with the provider to obtain credentials.
HTTPS Supported Traffic is encrypted in transit.
CORS Enabled Callable directly from browser JavaScript.
Pricing Freemium A usable free tier exists, with paid plans for more volume.
Formats JSON Responses can be requested as JSON.
GreatAPIs Score Score 81 out of 100
Authentication 15/25 API key required
Pricing 17/20 Freemium tier available
Docs 20/20 Machine-readable spec file bundled
Formats 9/15 Single response format
Freshness 20/20 Verified within 6 months
Embed this badge <a href="https://greatapis.com/api/spoonacular/"><img src="https://greatapis.com/badge/spoonacular.svg" alt="Scored 81 on greatapis.com"></a>
Auth quickstart Get a key at the provider Send it on every request as a header Authorization: <key>The exact header isn't documented — Authorization is a common default; confirm in the provider's docs. Stored key No key stored Clear key
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints ingredients 1 GET /food/ingredients/searchIngredient Search Parameters Name In Required Type addChildrenquery no boolean minProteinPercentquery no number maxProteinPercentquery no number minFatPercentquery no number maxFatPercentquery no number minCarbsPercentquery no number maxCarbsPercentquery no number metaInformationquery no boolean intolerancesquery no string sortquery no string sortDirectionquery no string
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
meal planning 5 GET /mealplanner/generateGenerate Meal Plan Parameters Name In Required Type timeFramequery no string targetCaloriesquery no number dietquery no string excludequery no string
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
GET /mealplanner/{username}/shopping-listGet Shopping List Parameters Name In Required Type usernamepath yes string
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
GET /mealplanner/{username}/templatesGet Meal Plan Templates Parameters Name In Required Type usernamepath yes string
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
POST /mealplanner/{username}/templatesAdd Meal Plan Template Parameters Name In Required Type usernamepath yes string hashquery yes string
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
GET /mealplanner/{username}/week/{start-date}Get Meal Plan Week Parameters Name In Required Type start-datepath yes string usernamepath yes string start-datepath yes string
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
menu items 1 GET /food/menuItems/searchSearch Menu Items Parameters Name In Required Type minCaloriesquery no number maxCaloriesquery no number minCarbsquery no number maxCarbsquery no number minProteinquery no number maxProteinquery no number minFatquery no number maxFatquery no number addMenuItemInformationquery no boolean
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
recipes 3 GET /recipes/complexSearchSearch Recipes Parameters Name In Required Type cuisinequery no string excludeCuisinequery no string dietquery no string intolerancesquery no string equipmentquery no string includeIngredientsquery no string excludeIngredientsquery no string typequery no string instructionsRequiredquery no boolean fillIngredientsquery no boolean addRecipeInformationquery no boolean addRecipeNutritionquery no boolean authorquery no string recipeBoxIdquery no number titleMatchquery no string maxReadyTimequery no number sortquery no string sortDirectionquery no string minCarbsquery no number maxCarbsquery no number minProteinquery no number maxProteinquery no number minCaloriesquery no number maxCaloriesquery no number minFatquery no number maxFatquery no number minAlcoholquery no number maxAlcoholquery no number minCaffeinequery no number maxCaffeinequery no number minCopperquery no number maxCopperquery no number minCalciumquery no number maxCalciumquery no number minCholinequery no number maxCholinequery no number minCholesterolquery no number maxCholesterolquery no number minFluoridequery no number maxFluoridequery no number minSaturatedFatquery no number maxSaturatedFatquery no number minVitaminAquery no number maxVitaminAquery no number minVitaminCquery no number maxVitaminCquery no number minVitaminDquery no number maxVitaminDquery no number minVitaminEquery no number maxVitaminEquery no number minVitaminKquery no number maxVitaminKquery no number minVitaminB1query no number maxVitaminB1query no number minVitaminB2query no number maxVitaminB2query no number minVitaminB5query no number maxVitaminB5query no number minVitaminB3query no number maxVitaminB3query no number minVitaminB6query no number maxVitaminB6query no number minVitaminB12query no number maxVitaminB12query no number minFiberquery no number maxFiberquery no number minFolatequery no number maxFolatequery no number minFolicAcidquery no number maxFolicAcidquery no number minIodinequery no number maxIodinequery no number minIronquery no number maxIronquery no number minMagnesiumquery no number maxMagnesiumquery no number minManganesequery no number maxManganesequery no number minPhosphorusquery no number maxPhosphorusquery no number minPotassiumquery no number maxPotassiumquery no number minSeleniumquery no number maxSeleniumquery no number minSodiumquery no number maxSodiumquery no number minSugarquery no number maxSugarquery no number minZincquery no number maxZincquery no number
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
GET /recipes/randomGet Random Recipes Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
GET /recipes/{id}/informationGet Recipe Information Parameters Name In Required Type idpath yes number
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
wine 1 GET /food/wine/pairingWine Pairing Parameters Name In Required Type foodquery yes string maxPricequery no number
Responses Status Description Schema 200Success — 401Unauthorized — 403Forbidden — 404Not Found —
Developer reference Base URL https://api.spoonacular.com
Rate limit Free tier: 50 points/day (each endpoint call costs 1 or more points)
Key endpoints GET /recipes/complexSearch GET /recipes/random GET /recipes/{id}/information GET /mealplanner/generate 