Recipe API
Every recipe includes grouped ingredients with linked IDs and USDA source traceability, 32 tracked nutrients per serving, step-by-step instructions with machine-readable actions, temperatures in Celsius and Fahrenheit, ISO 8601 durations, visual and tactile doneness cues, dietary flags, allergen warnings, storage and reheating guidance, troubleshooting, equipment with alternatives, chef notes,…
Recipe API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Public | ||
| GET |
/health /health |
|
| GET |
/api/v1/dinner /api/v1/dinner |
Returns a single delicious dinner recipe with all fields. Perfect for testing the API schema. Try it: `curl https://recipe-api.com/api/v1/dinner` |
| Discovery | ||
| GET |
/api/v1/cuisines /api/v1/cuisines |
Returns all cuisines with recipe counts. No credit cost. |
| GET |
/api/v1/dietary-flags /api/v1/dietary-flags |
Returns all dietary flags with recipe counts. No credit cost. |
| GET |
/api/v1/ingredient-categories /api/v1/ingredient-categories |
Returns all ingredient categories with counts. No credit cost. |
| GET |
/api/v1/categories /api/v1/categories |
Returns all recipe categories with recipe counts. No credit cost. |
| GET |
/api/v1/ingredients /api/v1/ingredients |
Returns a paginated list of ingredients with optional filtering by name or category. No credit cost. |
| Recipes | ||
| GET |
/api/v1/recipes/{id} /api/v1/recipes/{id} |
Returns complete recipe details including ingredients, instructions, and nutrition. **Costs 1 credit.** |
| POST |
/api/v1/generate /api/v1/generate |
Creates a new recipe from structured constraints. Includes USDA-verified nutrition calculation. Requires generate credits (separate from request limits). |
| GET |
/api/v1/recipes /api/v1/recipes |
Returns a paginated list of recipes with optional filtering. Discovery limited to 500 recipes; use filters for larger catalogs. No credit cost. |
Recipe API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|