Last Updated on April 11, 2014

The WebKnox Recipe API (developed in cooperation with spoonacular.com) provides you access to over 250,000 recipes. It also allows users to search for recipes using natural language, such as "high protein gluten free brownies without sugar". The API also makes it possible to visualize ingredient lists, show price breakdowns, calculate nutritional information, and create recipe cards -- automatically and for every recipe.

We hope the WebKnox Recipe API will make the web a tastier place. If you have any suggestions how we can do this better, please do not hesitate to share your ideas with us (here: http://spoonacular.com/about#contact).

Terms of Use

Acceptance of Terms

By using any of the WebKnox Recipe API packages offered on mashape.com (from the Freemium plan to the Ultra plan) or the WebKnox Recipe API widgets, you are confirming that you have read and agreed to the Terms of Use outlined below. Failure to honor these terms will result in your use of the API from being blocked. If you do not agree with being bound to the terms below, please do not use the WebKnox Recipe API.

License

Your license grants you access to the WebKnox Recipe API on a month-by-month basis dependent on your agreement to pay the monthly fee (and any additional charges due to exceeding the number of requests per day covered by your subscription) and on your agreement to respect these terms. You will be charged every month until you cancel your subscription on mashape.

Content

The WebKnox Recipe API has collected recipes and photographs from across the web. WebKnox does not own these recipes, which is why credit in the form of a link to the original source is always given. You MUST credit the original source on your website, app, etc. too. Should the original creator contact you to remove the recipe or the recipe's photograph from your website, it is your responsibility to let us know (via mashape) that the recipe should be removed from the API.

WebKnox does, however, own (a) ingredient images, (b) summary texts, (c) analyzed results (ingredients, nutrition, price data). You may use (a-c) for your website as part of your monthly subscription to the WebKnox Recipe API. You may not scrape the WebKnox Recipe API or in any way attempt to copy or store the information it provides, including any derived, hashed, or transformed data. You may cache the data to improve the performance of your service, but you must clear the cache as soon as your subscription expires and as soon as you stop paying for use of the WebKnox Recipe API. If you stop using the WebKnox Recipe API, if you are blocked from using the API on mashape, or if WebKnox asks you to stop using the API or to delete all data, then you must delete all data you obtained from the WebKnox Recipe API.

WebKnox also reserves the right to include our logo or the spoonacular logo, links to WebKnox or spoonacular, and/or advertisements (e.g. links or images related to sponsors) in the WebKnox Recipe API, including its widgets.

A Couple Prohibitions

You may use the data provided by the WebKnox Recipe API as part of your website, application, or other project, but you cannot attempt to use our data to create a site or application meant to provide the same experience as spoonacular. spoonacular is the world's best recipe search engine, which is why the data it uses (i.e. the WebKnox Recipe API!) is top of the line. Should WebKnox determine that your website or application is attempting to compete with spoonacular (for example by purporting to have the best recipe search engine) or drive traffic away from spoonacular in another way, you will no longer be allowed to use our API. In this case, however, you may reach out to us to discuss a possible business partnership.

You may not create the impression that your site is endorsed by WebKnox or spoonacular or is in any way related to these sites (for example by using the WebKnox or spoonacular logos). You can, however, contact us and ask us whether you can use our logos. In some cases we even give you discounts on API fees.

You can definitely use the WebKnox Recipe API in order to compare our API to our competitors.

Disclaimer

The WebKnox Recipe API and all the data it consists of are intended for informational purposes only, and are provided "as is," "with all faults," and "as available." This means that while WebKnox will do its best to ensure the quality of our API and the accuracy of our data, there are no guarantees or warranties (neither expressed nor implied). Thus, WebKnox is not accountable for any losses, damages, or any other problems that occur because the API is unavailable or slow or because the data contains errors. WebKnox is also not accountable for any copyrighted text or images that you show on your website, even if it comes from the WebKnox Recipe API. Again, should the creator of the text/image ask that the text/image be removed from your site and thus from the WebKnox Recipe API, you must immediately contact WebKnox via mashape so the copyrighted material can be promptly removed.

Updates

These Terms of Use may be updated or revised. You will be informed of major changes. If necessary, you will need to change your websites/app/etc. to be in compliance with these terms. Futhermore, we reserve the right to withdraw the permission to use the API without explanation.

Last 7 days, UTC

Average Latency
98ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Simple & Straightforward Pricing

Pay as you go. No long-term contracts.

Freemium

$0

additional fees may apply

requests

10 / day

$0.0050 per extra

widgets

100,000 / day

$0.0001 per extra

Commercial Usage

Best Recipe Search on the Web

Subscribe

basic

$25.00

per month

requests

250 / day

$0.0030 per extra

widgets

100,000 / day

$0.0001 per extra

Commercial Usage

Best Recipe Search on the Web

Support We respond to your inquiry within 1 week

Subscribe

ultra

$1000.00

per month

requests

20,000 / day

$0.0030 per extra

widgets

1,000 / day

$0.0100 per extra

Commercial Usage

Best Recipe Search on the Web

Support We respond to your inquires within 48 hours

Subscribe

Answer

HTTP 200 : Quick Answer GET/recipes/quickAnswer
The answer to a nutrition-related natural language question.
						{
  "answer": "In two apples, there are 16.7 mg of Vitamin C. This amount covers 20.0% of your daily needs of Vitamin C.",
  "image": "http://spoonacular.com/cdn/ingredients_100x100/apple.jpg"
}						
Quick Answer

Answer a nutrition related natural language question.


Test console
Description
Parameter
string

The nutrition-related question.
Example: How much vitamin c is in 2 apples?

q

Required

Classify

HTTP 200 : Classified Cuisine POST/recipes/cuisine
The classified cuisine.
						{
  "cuisines": [
    "Mexican"
  ],
  "cuisine": "Mexican",
  "confidence": 0.1899663233125781
}						
Classify Cuisine

Classify the recipe's cuisine.


Test console
Description
Parameter
string

The title of the recipe.
Example: Pork roast with green beans

title

Required

string

The ingredient list of the recipe, one ingredient per line.
Example: 3 oz pork shoulder

ingredientList

Required

Data

HTTP 200 : Similar Recipes GET/recipes/{id}/similar
A list of recipes that are similar to the given one.
						[[
  {
    "id": 116284,
    "title": "Grilled Beef Tenderloin with Herb-Garlic-Pepper Coating",
    "image": "grilled-beef-tenderloin-with-herb-garlic-pepper-coating-2-116284.png",
    "imageUrls": [
      "grilled-beef-tenderloin-with-herb-garlic-pepper-coating-2-116284.png",
      "grilled_beef_tenderloin_with_herb-garlic-pepper_coating-116284.jpg"
    ]
  },
  {
    "id": 9027,
    "title": "Sous Vide Beef Tenderloin With Arugula Chimichurri Sauce",
    "image": "sous_vide_beef_tenderloin_with_arugula_chimichurri_sauce-9027.JPG",
    "imageUrls": [
      "sous_vide_beef_tenderloin_with_arugula_chimichurri_sauce-9027.JPG",
      "sous-vide-beef-tenderloin-with-arugula-chimichurri-sauce-2-9027.jpg"
    ]
  },
  {
    "id": 144456,
    "title": "Argentinean Oak-Planked Beef Tenderloin with Chimichurri Sauce",
    "image": "argentinean-oak-planked-beef-tenderloin-with-chimichurri-sauce-2-144456.png",
    "imageUrls": [
      "argentinean-oak-planked-beef-tenderloin-with-chimichurri-sauce-2-144456.png",
      "argentinean_oak-planked_beef_tenderloin_with_chimichurri_sauce-144456.jpg"
    ]
  },
  {
    "id": 144777,
    "title": "Argentinean Oak-Planked Beef Tenderloin With Chimichurri Sauce",
    "image": "argentinean-oak-planked-beef-tenderloin-with-chimichurri-sauce-2-144777.jpg",
    "imageUrls": [
      "argentinean-oak-planked-beef-tenderloin-with-chimichurri-sauce-2-144777.jpg",
      "argentinean_oak-planked_beef_tenderloin_with_chimichurri_sauce-144777.jpg"
    ]
  },
  {
    "id": 82069,
    "title": "Grilled Pork Tenderloin With Chimichurri And Summer Veggies",
    "image": "grilled_pork_tenderloin_with_chimichurri_and_summer_veggies-82069.JPG",
    "imageUrls": [
      "grilled_pork_tenderloin_with_chimichurri_and_summer_veggies-82069.JPG",
      "grilled-pork-tenderloin-with-chimichurri-and-summer-veggies-2-82069.jpg"
    ]
  },
  {
    "id": 14047,
    "title": "Beef Tenderloin Sandwiches With Herb Mayonnaise",
    "image": "beef-tenderloin-sandwiches-with-herb-mayonnaise-2-14047.jpg",
    "imageUrls": [
      "beef-tenderloin-sandwiches-with-herb-mayonnaise-2-14047.jpg",
      "beef_tenderloin_sandwiches_with_herb_mayonnaise-14047.jpg"
    ]
  },
  {
    "id": 8770,
    "title": "Beef Tenderloin Sandwiches With Herb Mayonnaise And Arugula",
    "image": "beef_tenderloin_sandwiches_with_herb_mayonnaise_and_arugula-8770.jpg",
    "imageUrls": [
      "beef_tenderloin_sandwiches_with_herb_mayonnaise_and_arugula-8770.jpg",
      "beef-tenderloin-sandwiches-with-herb-mayonnaise-and-arugula-2-8770.jpg"
    ]
  },
  {
    "id": 36460,
    "title": "Lobster Risotto With Herb-rubbed Beef Tenderloin",
    "image": "lobster_risotto_with_herb-rubbed_beef_tenderloin-36460.jpg",
    "imageUrls": [
      "lobster_risotto_with_herb-rubbed_beef_tenderloin-36460.jpg",
      "lobster-risotto-with-herb-rubbed-beef-tenderloin-2-36460.jpg"
    ]
  },
  {
    "id": 79513,
    "title": "Peppered Beef Tenderloin With Roasted Garlic?herb Butter",
    "image": "peppered-beef-tenderloin-with-roasted-garlic-herb-butter-2-79513.jpg",
    "imageUrls": [
      "peppered-beef-tenderloin-with-roasted-garlic-herb-butter-2-79513.jpg",
      "peppered_beef_tenderloin_with_roasted_garlicherb_butter-79513.jpg"
    ]
  }
]]						
Find Similar Recipes

Find recipes which are similar to the given one.


Test console
Description
Parameter
string

The id of the source recipe to which similar recipes should be found.
Example: 156992

id

Required

HTTP 200 : Parsed Ingredients POST/recipes/parseIngredients
Parsed Ingredients
						[[
  {
    "amount": 3,
    "unitShort": "oz",
    "aisle": "meat",
    "name": "pork shoulder",
    "original": "3 oz pork shoulder",
    "image": "http://spoonacular.com/cdn/ingredients_100x100/pork-shoulder.jpg",
    "unitLong": "ounces",
    "meta": []
  }
]]						
Parse Ingredients

Parse ingredient descriptions.


Test console
Description
Parameter
string

The ingredient list of the recipe, one ingredient per line.
Example: 3 oz pork shoulder

ingredientList

Required

number

The number of servings that you can make from the ingredients.
Example: 2

servings

Required

HTTP 200 : Recipe Information GET/recipes/{id}/information
Basic information about a recipe.
						{
  "vegetarian": false,
  "vegan": false,
  "glutenFree": true,
  "dairyFree": true,
  "veryHealthy": false,
  "cheap": false,
  "veryPopular": false,
  "sustainable": false,
  "servings": 8,
  "sourceUrl": "http://www.epicurious.com/recipes/food/views/Char-Grilled-Beef-Tenderloin-with-Three-Herb-Chimichurri-235342",
  "spoonacularSourceUrl": "http://spoonacular.com/Char-Grilled-Beef-Tenderloin-with-Three-Herb-Chimichurri-156992",
  "aggregateLikes": 139,
  "extendedIngredients": [
    {
      "name": "dark brown sugar",
      "amount": 2,
      "unit": "tablespoon",
      "unitShort": "T",
      "unitLong": "tablespoons",
      "originalString": "2 tablespoons dark brown sugar",
      "metaInformation": []
    },
    {
      "name": "sweet smoked paprika",
      "amount": 1,
      "unit": "tablespoon",
      "unitShort": "T",
      "unitLong": "tablespoon",
      "originalString": "1 tablespoon sweet smoked paprika*",
      "metaInformation": []
    },
    {
      "name": "coarse kosher salt",
      "amount": 1,
      "unit": "tablespoon",
      "unitShort": "T",
      "unitLong": "tablespoon",
      "originalString": "1 tablespoon coarse kosher salt",
      "metaInformation": []
    },
    {
      "name": "ancho chile powder",
      "amount": 1.5,
      "unit": "teaspoon",
      "unitShort": "t",
      "unitLong": "teaspoons",
      "originalString": "1 1/2 teaspoons chipotle chile powder or ancho chile powder",
      "metaInformation": []
    },
    {
      "name": "ground black pepper",
      "amount": 1,
      "unit": "teaspoon",
      "unitShort": "t",
      "unitLong": "teaspoon",
      "originalString": "1 teaspoon ground black pepper",
      "metaInformation": []
    },
    {
      "name": "olive oil",
      "amount": 2,
      "unit": "tablespoon",
      "unitShort": "T",
      "unitLong": "tablespoons",
      "originalString": "2 tablespoons olive oil",
      "metaInformation": []
    },
    {
      "name": "red wine vinegar",
      "amount": 3,
      "unit": "tablespoon",
      "unitShort": "T",
      "unitLong": "tablespoons",
      "originalString": "3 tablespoons Sherry wine vinegar or red wine vinegar",
      "metaInformation": []
    },
    {
      "name": "lemon juice",
      "amount": 3,
      "unit": "tablespoon",
      "unitShort": "T",
      "unitLong": "tablespoons",
      "originalString": "3 tablespoons fresh lemon juice",
      "metaInformation": [
        "fresh"
      ]
    },
    {
      "name": "garlic cloves",
      "amount": 3,
      "unit": "",
      "unitShort": "",
      "unitLong": "",
      "originalString": "3 garlic cloves, peeled",
      "metaInformation": [
        "peeled"
      ]
    },
    {
      "name": "shallots",
      "amount": 2,
      "unit": "",
      "unitShort": "",
      "unitLong": "",
      "originalString": "2 medium shallots, peeled, quartered",
      "metaInformation": [
        "peeled",
        "quartered",
        "medium"
      ]
    },
    {
      "name": "fine sea salt",
      "amount": 1,
      "unit": "teaspoon",
      "unitShort": "t",
      "unitLong": "teaspoon",
      "originalString": "1 teaspoon fine sea salt",
      "metaInformation": []
    },
    {
      "name": "black pepper",
      "amount": 0.5,
      "unit": "teaspoon",
      "unitShort": "t",
      "unitLong": "teaspoons",
      "originalString": "1/2 teaspoon freshly ground black pepper",
      "metaInformation": [
        "freshly ground"
      ]
    },
    {
      "name": "dried red pepper",
      "amount": 0.5,
      "unit": "teaspoon",
      "unitShort": "t",
      "unitLong": "teaspoons",
      "originalString": "1/2 teaspoon dried crushed red pepper",
      "metaInformation": [
        "crushed"
      ]
    },
    {
      "name": "parsley",
      "amount": 3,
      "unit": "cups",
      "unitShort": "c",
      "unitLong": "cups",
      "originalString": "3 cups (packed) stemmed fresh parsley",
      "metaInformation": [
        "stemmed",
        "(packed)",
        "fresh"
      ]
    },
    {
      "name": "cilantro",
      "amount": 2,
      "unit": "cups",
      "unitShort": "c",
      "unitLong": "cups",
      "originalString": "2 cups (packed) stemmed fresh cilantro",
      "metaInformation": [
        "stemmed",
        "(packed)",
        "fresh"
      ]
    },
    {
      "name": "mint",
      "amount": 1,
      "unit": "cup",
      "unitShort": "c",
      "unitLong": "cup",
      "originalString": "1 cup (packed) stemmed fresh mint",
      "metaInformation": [
        "stemmed",
        "(packed)",
        "fresh"
      ]
    },
    {
      "name": "beef",
      "amount": 3.5,
      "unit": "pound",
      "unitShort": "lb",
      "unitLong": "pounds",
      "originalString": "1 3 1/2-pound beef tenderloin",
      "metaInformation": []
    }
  ],
  "id": 156992,
  "title": "Char-Grilled Beef Tenderloin with Three-Herb Chimichurri",
  "image": "Char-Grilled-Beef-Tenderloin-with-Three-Herb-Chimichurri-156992.jpg",
  "imageUrls": [
    "Char-Grilled-Beef-Tenderloin-with-Three-Herb-Chimichurri-156992.jpg"
  ]
}						
Recipe Information

Get information about a recipe.


Test console
Description
Parameter
string

The id of the recipe.
Example: 156992

id

Required

Search

HTTP 200 : Search Result GET/recipes/search
The results of a recipe search.
						{
  "expires": 1380752010364,
  "results": [
    {
      "id": 95004,
      "title": "Lentil Soup",
      "imageUrls": [
        "lentil-soup-2-95004.png",
        "lentil_soup-95004.jpg"
      ],
      "image": "lentil-soup-2-95004.png"
    },
    {
      "id": 20291,
      "title": "Pomegranate Lentil Soup",
      "imageUrls": [
        "pomegranate_lentil_soup-20291.jpg",
        "pomegranate-lentil-soup-2-20291.jpg"
      ],
      "image": "pomegranate_lentil_soup-20291.jpg"
    },
    {
      "id": 20365,
      "title": "Crockpot Lentil Soup",
      "imageUrls": [
        "crockpot_lentil_soup-20365.jpg",
        "crockpot-lentil-soup-2-20365.jpg"
      ],
      "image": "crockpot_lentil_soup-20365.jpg"
    },
    {
      "id": 33824,
      "title": "Lentil-barley Soup",
      "imageUrls": [
        "lentil-barley_soup-33824.jpg",
        "lentil-barley-soup-2-33824.jpg"
      ],
      "image": "lentil-barley_soup-33824.jpg"
    },
    {
      "id": 33883,
      "title": "Lentil Cream Soup",
      "imageUrls": [
        "lentil-cream-soup-2-33883.jpg"
      ],
      "image": "lentil-cream-soup-2-33883.jpg"
    },
    {
      "id": 34004,
      "title": "Blended Lentil Soup",
      "imageUrls": [
        "blended_lentil_soup-34004.jpg",
        "blended-lentil-soup-2-34004.jpg"
      ],
      "image": "blended_lentil_soup-34004.jpg"
    },
    {
      "id": 34024,
      "title": "Sicilian Lentil Soup",
      "imageUrls": [
        "sicilian-lentil-soup-2-34024.jpg"
      ],
      "image": "sicilian-lentil-soup-2-34024.jpg"
    },
    {
      "id": 34044,
      "title": "Lentil Soup With Yams",
      "imageUrls": [
        "lentil_soup_with_yams-34044.jpg",
        "lentil-soup-with-yams-2-34044.jpg"
      ],
      "image": "lentil_soup_with_yams-34044.jpg"
    },
    {
      "id": 34047,
      "title": "Vegetable Lentil Soup",
      "imageUrls": [
        "vegetable_lentil_soup-34047.JPG",
        "vegetable-lentil-soup-2-34047.jpg"
      ],
      "image": "vegetable_lentil_soup-34047.JPG"
    },
    {
      "id": 34093,
      "title": "French Lentil Soup",
      "imageUrls": [
        "french-lentil-soup-2-34093.jpg",
        "french_lentil_soup-34093.jpg"
      ],
      "image": "french-lentil-soup-2-34093.jpg"
    }
  ],
  "number": 10,
  "offset": 0,
  "processingTimeMs": 123045,
  "isStale": false
}						
Search Recipes

Search recipes in natural language.


Test console
Description
Parameter
string

The (natural language) search query.
Example: vegetarian dairy-free lentil soup

query

Required

number

The number of results to skip (between 0 and 900).
Example: 0

offset

Optional

number

The number of results to return (between 0 and 100).
Example: 10

number

Optional

string

The type of the recipes. One of the following: main course, side dish, dessert, appetizer, salad, bread, breakfast, soup, beverage, sauce, or drink.
Example: main course

type

Optional

string

The cuisine(s) of the recipes. One or more (comma separated) of the following: african, chinese, japanese, korean, vietnamese, thai, indian, british, irish, french, italian, mexican, spanish, middle eastern, jewish, american, cajun, southern, greek, german, nordic, eastern european, caribbean, or latin american.
Example: italian

cuisine

Optional

string

The diet to which the recipes must be compliant. Possible values are: pescetarian, lacto vegetarian, ovo vegetarian, vegan, and vegetarian.
Example: vegetarian

diet

Optional

string

A comma-separated list of intolerances. All found recipes must not have ingredients that could cause problems for people with one of the given tolerances. Possible values are: dairy, egg, gluten, peanut, sesame, seafood, shellfish, soy, sulfite, tree nut, and wheat.
Example: egg, gluten

intolerances

Optional

string

An comma-separated list of ingredients or ingredient types that must not be contained in the recipes.
Example: coconut

excludeIngredients

Optional

Summarize

HTTP 200 : Summarization GET/recipes/{id}/summary
The summary of a recipe.
						{
  "summary": "The Soy-and-ginger-glazed Salmon With Udon Noodles is ready in 256 minutes. With $3.39 per serving, the recipe is rather expensive. One serving covers 8% of your daily needs of minerals and vitamins, therefore this recipe can be considered unhealthy.",
  "id": 4632,
  "title": "Soy-and-ginger-glazed Salmon With Udon Noodles"
}						
Summarize Recipe

Summarize the recipe in a short text.


Test console
Description
Parameter
string

The id of the recipe to summarize.
Example: 4632

id

Required

Widget

HTTP 200 : string POST/recipes/visualizeRecipe
Create Recipe Card

Create a recipe card given a recipe. This widget is basically free of charge.


Test console
Description
Parameter
string

The title of the recipe.
Example: Pork tenderloin with green beans

title

Required

string

The ingredient list of the recipe, one ingredient per line.
Example: 2 cups of green beans

ingredients

Required

string

The instructions to make the recipe.
Example: cook the beans

instructions

Required

number

The number of servings that you can make from the ingredients.
Example: 2

servings

Required

number

The number of minutes it takes to get the recipe on the table.
Example: 45

readyInMinutes

Required

string

The author of the recipe.
Example: John Doe

author

Optional

string

The source of the recipe.
Example: spoonacular.com

source

Optional

string

The background image ("none","background1", or "background2").
Example: background1

backgroundImage

Required

string

The mask to put over the recipe image ("ellipseMask", "diamondMask", "diamondMask", "starMask", "heartMask", "potMask", "fishMask").
Example: ellipseMask

mask

Required

string

The font color on the recipe card as a hex-string.
Example: #333333

fontColor

Optional

string

The background color on the recipe card as a hex-string.
Example: #ffffff

backgroundColor

Optional

binary

The binary image of the recipe as jpg.

image

Required

HTTP 200 : string POST/recipes/visualizeIngredients
Visualize Ingredients

Visualize ingredients of a recipe. This widget is basically free of charge.


Test console
Description
Parameter
string

The ingredient list of the recipe, one ingredient per line.
Example: 3 oz flour

ingredientList

Required

string

The initial view, either "grid" or "list".
Example: grid

view

Optional

string

The initial measure, either "metric" or "us".
Example: metric

measure

Optional

number

The initial number of servings.
Example: 2

servings

Required

boolean

Whether the ingredient list should be styled with the default css.

defaultCss

Optional

HTTP 200 : string POST/recipes/visualizeNutrition
Visualize Nutrition

Visualize a recipe's nutritional information.


Test console
Description
Parameter
string

The ingredient list of the recipe, one ingredient per line.
Example: 3 oz flour

ingredientList

Required

number

The number of servings.
Example: 2

servings

Required

boolean

Whether the ingredient list should be styled with the default css.

defaultCss

Optional

HTTP 200 : string POST/recipes/visualizePriceEstimator
Visualize Price Breakdown

Visualize the price breakdown of a recipe. This widget is basically free of charge.


Test console
Description
Parameter
string

The ingredient list of the recipe, one ingredient per line.
Example: 3 oz flour

ingredientList

Required

number

The number of servings.
Example: 2

servings

Required

boolean

Whether the widget should be styled with the default css.

defaultCss

Optional

number

The mode in which the widget should be delivered. 1 = separate views (compact), 2 = all in one view (full).
Example: 1

mode

Optional

You must have an API key to test this API!


Mashape allows developers to find, consume, and distribute cloud APIs just like Recipes.

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.