January Sale! Get over 30% off when you subscribe to an annual plan!

Recipe API

The Recipe API provides access to over 200,000 recipes from all cuisines.

(4.8)

From 6,055 users

4,300+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
388ms407ms475ms760ms1307ms

Didn't find what you were looking for? Suggest an improvement

/v3/recipe GET

https://api.api-ninjas.com/v3/recipe

Get a list of recipes for a given recipe name or ingredient(s). Returns a list of recipes. To access more results, use the limit parameter to limit the number of results and the offset parameter to offset results for pagination in multiple API calls.

Parameters

Either title or ingredients parameter must be provided.

  • title  optional

    Recipe title to search for.

  • ingredients  optionalpremium only

    Comma-separated list of ingredients to search for.

  • limit  optionalpremium only

    Number of results to return. Must be between 1 and 10. If not set, a default value of 1 will be used.

  • offset  optionalpremium only

    Number of results to offset for pagination.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

Returns an array of recipe objects matching the query. Each object contains the following fields:

  • title

    Recipe title.

  • ingredients

    Array of ingredient strings. Each ingredient contains the name and quantity.

  • servings

    Serving information / yield description.

  • instructions

    Full text instructions describing how to prepare the recipe.

  • nutrition  premium only

    Nutrition information object containing calories, fat, saturated fat, protein, sodium, potassium, dietary fiber, cholesterol, sugars, and total carbohydrates.

Sample Request Live Demo!

title
ingredients

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v3/recipe?title=lentil%20soup

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v3/recipe?title=lentil%20soup" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.