Why Use CookSave API?
CookSave API provides access to a curated collection of recipes specifically chosen to help people save money by cooking at home instead of dining out.
- Cost-savings calculated for every recipe
- Nutritional information included
- Multi-language support (EN, DE)
- Rich filtering and search capabilities
- Real-time data updates
- Comprehensive ingredient lists
- Step-by-step cooking instructions
Example Recipe Data
{
"id": 1,
"names": {
"en": "Homemade Pasta Carbonara",
"de": "Hausgemachte Pasta Carbonara"
},
"cuisine": "Italian",
"difficulty": "Medium",
"cookingTime": 30,
"servings": 4,
"restaurantPrice": 18,
"homeCost": 4.5,
"savings": 13.5,
"savingsPercentage": 75,
"nutritionalInfo": {
"calories": 520,
"protein": 22,
"carbs": 58,
"fat": 18
}
}API Reference
Base URL: https://cooksave-api-140650164625.us-central1.run.app/api
/recipes
Description: Get all recipes with optional filtering and pagination
Parameters: search, cuisine, category, difficulty, max_time, min_savings, page, limit
Authentication: Optional
/recipes/{id}
Description: Get a specific recipe by ID or slug
Parameters: language
Authentication: Optional
/recipes
Description: Create a new recipe
Parameters: names, descriptions, cuisine, category, ingredients, instructions
Authentication: Required
/recipes/{id}
Description: Update an existing recipe
Parameters: names, descriptions, cuisine, category, ingredients, instructions
Authentication: Required (owner only)
/recipes/{id}/cook
Description: Mark a recipe as cooked (saves to user history)
Authentication: Required
/recipes/meta/categories
Description: Get all available recipe categories
Authentication: None
/recipes/meta/cuisines
Description: Get all available cuisines
Authentication: None
/recipes/meta/stats
Description: Get recipe statistics
Authentication: None
Code Examples
JavaScript / Node.js
const response = await fetch('https://cooksave-api-140650164625.us-central1.run.app/api/recipes?cuisine=italian&limit=10', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data.recipes);Python
import requests
response = requests.get(
'https://cooksave-api-140650164625.us-central1.run.app/api/recipes',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
params={
'cuisine': 'italian',
'limit': 10
}
)
data = response.json()
print(data['recipes'])cURL
curl -X GET "https://cooksave-api-140650164625.us-central1.run.app/api/recipes?cuisine=italian&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Get Started Today
Ready to build with CookSave API?
Join developers who are already building amazing food and savings apps with our API.