Edamam recipes API

⭐ Beginner's Pick Food & Drink / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

The Edamam Recipe Search API lets you search a database of over 2 million recipes filtered by ingredients, diet labels such as vegan or keto, meal type, and cuisine. Authentication uses an app ID and app key, both obtained free from the Edamam developer portal. It is a great starting point for food apps that need rich, filterable recipe data with nutritional information included.

💡

Beginner Tip

Use the diet and health query parameters (e.g., &diet=balanced&health=vegan) to narrow results — without filters you may get thousands of matches.

Available Data

recipe name and ingredients
nutritional values
calorie count
serving size
preparation time
Use case: Integrate recipe search data into web and mobile applications

Example Response

JSON Response
{
  "recipe": "Chicken Stir Fry",
  "calories": 380,
  "protein_g": 32,
  "carbs_g": 28,
  "fat_g": 14,
  "ingredients": [
    "chicken breast",
    "bell pepper",
    "soy sauce",
    "garlic"
  ],
  "prep_time_minutes": 20
}

Field Reference

label Name of the recipe.
image URL to the recipe thumbnail image.
source Name of the website or publication that published the recipe.
url Link to the full recipe on the source website.
calories Total calories for the entire recipe.
ingredientLines List of ingredient strings exactly as written in the original recipe.

Implementation Example

const url = "https://developer.edamam.com/edamam-docs-recipe-api";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized app_id and app_key are missing or swapped.
Add both &app_id=YOUR_APP_ID&app_key=YOUR_APP_KEY to the query string — both are required.
type parameter missing error The v2 endpoint requires a type=public parameter that the v1 endpoint did not need.
Always include &type=public in your request URL when using the v2 endpoint.
Empty hits array for a common ingredient Strict diet or health filters combined with a narrow ingredient search can yield zero results.
Remove health and diet filters one at a time to identify which constraint is too restrictive.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Food & Drink
Difficulty Intermediate
Verified: 2026-04-04

Recipes Using Edamam recipes

Build something with this API. Each recipe includes step-by-step instructions and code outlines.

Similar APIs

View All →