YourFoodAPI
**YourFoodAPI** — Bilingual (English + Polish) food and nutrition data API for fitness, meal planning, and health apps. ## What's inside - **3,122 ingredients** with full nutrition per 100 g — energy (kcal + kJ), protein, carbs, sugars, fats, saturated fats, fiber, salt, sodium - **370 recipes** with step-by-step instructions, ingredient lists (in grams), per-serving macros, and tags (breakfast,…
YourFoodAPI endpoints
| Method | Endpoint | Description |
|---|---|---|
| ingredients | ||
| GET |
getRandomIngredient /ingredients/random |
Returns a single random ingredient. Useful for daily food picks, app demos, and discovery features. |
| GET |
listIngredients /ingredients |
List ingredients with optional filters and pagination. Over 3000 ingredients available. |
| GET |
getIngredient /ingredients/{ingredient_id} |
|
| GET |
searchIngredients /ingredients/search |
|
| GET |
listIngredientCategories /ingredients/categories |
|
| GET |
listIngredientTags /ingredients/tags |
|
| recipes | ||
| GET |
getRandomRecipe /recipes/random |
Returns a single random recipe. Perfect for 'recipe of the day' features, app demos, and meal inspiration. |
| GET |
findRecipesByIngredients /recipes/by-ingredients |
Rank recipes by how many of your ingredients they use. Pass ingredients you have via repeated `have` query params. Returns recipes sorted by match ratio, with missing ingredient… |
| GET |
listRecipeTags /recipes/tags |
|
| GET |
getRecipe /recipes/{recipe_id} |
|
| GET |
searchRecipes /recipes/search |
|
| GET |
findRecipesByMacros /recipes/by-macros |
Return recipes closest to provided macro targets (kcal/protein/carbs/fats). |
| GET |
listRecipes /recipes |
List recipes with rich filters: tags, macros, included/excluded ingredients. |
| GET |
getScaledRecipe /recipes/{recipe_id}/scaled |
Returns the recipe with ingredient amounts and per-serving macros recalculated for the requested servings. |
| nutrition | ||
| POST |
calculateNutrition /nutrition/calculate |
Given a list of ingredient names and gram amounts, returns per-item nutrition (scaled from per-100g base values) and totals. Names are fuzzy-matched against the EN + PL… |
| meta | ||
| GET |
getDatasetStats /meta/stats |
High-level statistics over the entire dataset — counts per category and per tag, total ingredient and recipe counts, supported languages, API version. Useful for building filter… |
YourFoodAPI pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $9.99 / month | 5 / second |
|
| ULTRA | $49.99 / month | 15 / second |
|
| MEGA | $199 / month | 30 / second |
|