Search Recipes

Search and filter thousands of recipes with natural language, e.g. pasta recipes without mushrooms but with truffles. You can filter by ingredients, diet, cuisine, meal type, macro and micro nutrition, intolerances, and much more.

Recipe Sorting Options

This is a list of possible values for the sort parameter.

  • (empty)
  • meta-score
  • popularity
  • healthiness
  • price
  • time
  • random
  • max-used-ingredients
  • min-missing-ingredients
  • alcohol
  • caffeine
  • copper
  • energy
  • calories
  • calcium
  • carbohydrates
  • carbs
  • choline
  • cholesterol
  • total-fat
  • fluoride
  • trans-fat
  • saturated-fat
  • mono-unsaturated-fat
  • poly-unsaturated-fat
  • fiber
  • folate
  • folic-acid
  • iodine
  • iron
  • magnesium
  • manganese
  • vitamin-b3
  • niacin
  • vitamin-b5
  • pantothenic-acid
  • phosphorus
  • potassium
  • protein
  • vitamin-b2
  • riboflavin
  • selenium
  • sodium
  • vitamin-b1
  • thiamin
  • vitamin-a
  • vitamin-b6
  • vitamin-b12
  • vitamin-c
  • vitamin-d
  • vitamin-e
  • vitamin-k
  • sugar
  • zinc

Health Score ('healthiness')

Score % (between 0 and 100) = Average coverage of "good" nutrients - Average coverage of "bad" nutrients.

That is, the more of your daily requirements of vitamins and minerals are covered and lower amounts of things you should limit (sugar, salt etc.) the higher the score.

GET
https://api.apileague.com/search-recipes
Example Request and Response
GET
https://api.apileague.com/{{ examples.getSearchRecipes }}
{
    "offset": 0,
    "number": 3,
    "recipes": [
        {
            "id": 654913,
            "title": "Pasta With Chicken and Mushrooms",
            "images": [
                "https://img.spoonacular.com/recipes/654913-312x231.jpg"
            ],
            "nutrition": {
                "nutrients": [
                    {
                        "name": "Protein",
                        "amount": 36.1306,
                        "unit": "g"
                    }
                ]
            }
        },
        {
            "id": 655582,
            "title": "Penne Pasta With Chicken And Mushrooms",
            "images": [
                "https://img.spoonacular.com/recipes/655582-312x231.jpg"
            ],
            "nutrition": {
                "nutrients": [
                    {
                        "name": "Protein",
                        "amount": 40.6552,
                        "unit": "g"
                    }
                ]
            }
        },
        {
            "id": 1096241,
            "title": "Spaghetti with Peas, Mushrooms, and Tomato Sauce",
            "images": [
                "https://img.spoonacular.com/recipes/1096241-312x231.jpg"
            ],
            "nutrition": {
                "nutrients": [
                    {
                        "name": "Protein",
                        "amount": 39.1976,
                        "unit": "g"
                    }
                ]
            }
        }
    ],
    "total_results": 18
}
cURL
Java
Javascript
Python
Go
C#
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}