openapi: 3.0.3
info:
version: '2.9'
title: Recipe Search and Shopping List API
description: ''
servers:
- url: https://api.edamam.com
tags:
- name: Recipe Search
description: Search or access individual recipes.
- name: Shopping List
description: |-
The *Shopping List API* provides aggregation of shopping item quantities over one or more ingredient lists, and
optional referral to external shopping services.
A `shopping-list` call may be issued on a recipe preparation plan, e.g. for recipes assigned to a meal plan's
slots, to obtain total shopping quantities for the products involved. Each item in the plan may be scaled
individually for the shopping list by indicating the planned consumption as a number of servings; in the absence
of such indication, consumption (and therefore preparation) of the complete output of the recipe will be assumed.
Both recipes and directly consumable foodstuffs are supported as items in the plan.
paths:
/api/recipes/v2:
get:
tags:
- Recipe Search
security:
- app_id: []
app_key: []
Edamam-Account-User: []
- basic: []
Edamam-Account-User: []
summary: Search for a Recipe
description: |-
This endpoint returns a list of recipes matching the provided criteria. Get started by placing your search query
in the `q` parameter, fill in your 3scale credentials, and press the "Try it out!" button at the bottom.
Additionally, refine your search by using the optional parameters to specify what you are looking for.
__Note:__
- When mentioned, 'floating point values' refers to values such as `50.0`, `50.`, `0.5`, and `.5`.
- When speaking of ranges, the API accepts values such as `1.0+`, `1.0-50.0`, or `50.0`, for floating point
ranges.
The parameters with __(required)__ in their value box are the required parameters and must be defined as part
of a request, all others can be left blank if you do not wish to define them.
__Access Point:__ https://api.edamam.com/api/recipes/v2
parameters:
- name: type
in: query
description: Type of recipes to search for. For backward compatibility you can also specify `any` and it will
be equivalent to specifying all enumerated values.
required: true
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- public
- user
- edamam-generic
- name: beta
in: query
description: Allow beta features in the request and response
schema:
type: boolean
- name: q
in: query
description: Query text, for example "chicken".<br>
__REQUIRED__ if no other parameter is specified.
__NOT REQUIRED__ if any other parameter (other than application credentials) is specified.
schema:
type: string
- name: ingr
in: query
description: |
Filter by number of ingredients (MIN+, MIN-MAX, MAX), where MIN and MAX are integer numbers.
Example: `ingr=5-8`
schema:
pattern: (?:[+-]?\d+)|(?:(?:[+-]?\d+)-(?:[+-]?\d+))|(?:(?:[+-]?\d+)[+-])
type: string
- name: diet
in: query
description:
Diet label. You can select multiple labels by holding shift and left-clicking all the labels needed.
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- balanced
- high-fiber
- high-protein
- low-carb
- low-fat
- low-sodium
- name: health
in: query
description:
Health label. You can select multiple labels by holding shift and left-clicking all the labels needed.
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- alcohol-cocktail
- alcohol-free
- celery-free
- crustacean-free
- dairy-free
- DASH
- egg-free
- fish-free
- fodmap-free
- gluten-free
- immuno-supportive
- keto-friendly
- kidney-friendly
- kosher
- low-fat-abs
- low-potassium
- low-sugar
- lupine-free
- Mediterranean
- mollusk-free
- mustard-free
- no-oil-added
- paleo
- peanut-free
- pescatarian
- pork-free
- red-meat-free
- sesame-free
- shellfish-free
- soy-free
- sugar-conscious
- sulfite-free
- tree-nut-free
- vegan
- vegetarian
- wheat-free
- name: cuisineType
in: query
description: The type of cuisine of the recipe
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- American
- Asian
- British
- Caribbean
- Central Europe
- Chinese
- Eastern Europe
- French
- Greek
- Indian
- Italian
- Japanese
- Korean
- Kosher
- Mediterranean
- Mexican
- Middle Eastern
- Nordic
- South American
- South East Asian
- name: mealType
in: query
description: The type of meal a recipe belongs to
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- Breakfast
- Dinner
- Lunch
- Snack
- Teatime
- name: dishType
in: query
description: The dish type a recipe belongs to
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- Biscuits and cookies
- Bread
- Cereals
- Condiments and sauces
- Desserts
- Drinks
- Main course
- Pancake
- Preps
- Preserve
- Salad
- Sandwiches
- Side dish
- Soup
- Starter
- Sweets
- name: calories
in: query
description: |
The format is calories=RANGE where RANGE is in one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers. The + symbol needs to be properly encoded. Example: `calories=100-300`
will return all recipes with which have between 100 and 300 kcal per serving.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: time
in: query
description: |
Time range for the total cooking and prep time for a recipe. The format is time=RANGE where RANGE is one of
MIN+, MIN-MAX or MAX, where MIN and MAX are non-negative integer numbers. The + symbol needs to be properly
encoded. Example: `time=1%2B` will return all recipes with available total time greater then 1 minute.
schema:
pattern: (?:[+-]?\d+)|(?:(?:[+-]?\d+)-(?:[+-]?\d+))|(?:(?:[+-]?\d+)[+-])
type: string
- name: imageSize
in: query
description: Show only recipes, which have images with selected sizes
explode: true
schema:
type: array
items:
type: string
enum:
- LARGE
- REGULAR
- SMALL
- THUMBNAIL
- name: glycemicIndex
in: query
description: Filter by glycemic index. The format is FLOAT-RANGE
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: inflammatoryIndex
in: query
description: Filter by diet inflammatory index. The format is FLOAT-RANGE
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: excluded
in: query
description: |
Excluding recipes with certain ingredients. The format is `excluded=FOOD` where FOOD is replaced by the name
of the specific food you don't want to be present in the recipe results. More than one food can be excluded
at the same time. Example: excluded=vinegar&excluded=pretzel will exclude any recipes which contain vinegar
or pretzels in their ingredient list.
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
- name: random
in: query
description: |
Select whether you want this query to respond with a random selection of 20 recipes based on the criteria
filled. If there were only 20 or less possible results, this will return those results in random order.
schema:
type: boolean
- name: nutrients[CA]
in: query
description: |
Calcium, Ca. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
For example: `nutrients[CA]=50+` means minimum 50mg calcium, where `50+` has to be properly encoded as
`50%2B` `nutrients[FAT]=30` means maximum 30g fat and `nutrients[FE]=5-10` means iron between 5mg and 10mg
inclusive.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[CHOCDF]
in: query
description: |
Carbohydrate, by difference. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and
MAX are non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[CHOCDF.net]
in: query
description: |
Carbohydrates (net). Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[CHOLE]
in: query
description: |
Cholesterol. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[ENERC_KCAL]
in: query
description: |
Energy. Unit: kcal. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are non-negative
floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FAMS]
in: query
description: |
Fatty acids, total monounsaturated. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN
and MAX are non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FAPU]
in: query
description: |
Fatty acids, total polyunsaturated. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN
and MAX are non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FASAT]
in: query
description: |
Fatty acids, total saturated. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and
MAX are non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FAT]
in: query
description: |
Total lipid (fat). Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FATRN]
in: query
description: |
Fatty acids, total trans. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX
are non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FE]
in: query
description: |
Iron, Fe. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are non-negative
floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FIBTG]
in: query
description: |
Fiber, total dietary. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FOLAC]
in: query
description: |
Folic acid. Unit: µg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FOLDFE]
in: query
description: |
Folate, DFE. Unit: µg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[FOLFD]
in: query
description: |
Folate (food). Unit: µg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[K]
in: query
description: |
Potassium, K. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[MG]
in: query
description: |
Magnesium. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[NA]
in: query
description: |
Sodium, Na. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[NIA]
in: query
description: |
Niacin. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are non-negative
floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[P]
in: query
description: |
Phosphorus, P. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[PROCNT]
in: query
description: |
Protein. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are non-negative
floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[RIBF]
in: query
description: |
Riboflavin. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[SUGAR]
in: query
description: |
Sugars, total. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[SUGAR.added]
in: query
description: |
Sugars, added. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[Sugar.alcohol]
in: query
description: |
Sugar alcohols. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[THIA]
in: query
description: |
Thiamin. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are non-negative
floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[TOCPHA]
in: query
description: |
Vitamin E (alpha-tocopherol). Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and
MAX are non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[VITA_RAE]
in: query
description: |
Vitamin A, RAE. Unit: µg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[VITB12]
in: query
description: |
Vitamin B12. Unit: µg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[VITB6A]
in: query
description: |
Vitamin B6. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[VITC]
in: query
description: |
Vitamin C, total ascorbic acid. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN
and MAX are non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[VITD]
in: query
description: |
Vitamin D (D2 + D3). Unit: µg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are
non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[VITK1]
in: query
description: |
Vitamin K (phylloquinone). Unit: µg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX
are non-negative floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[WATER]
in: query
description: |
Water. Unit: g. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are non-negative
floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: nutrients[ZN]
in: query
description: |
Zinc, Zn. Unit: mg. Input the range which is one of MIN+, MIN-MAX or MAX, where MIN and MAX are non-negative
floating point numbers.<br>
See calcium for an example for how to fill in the range.
schema:
pattern: (?:[+-]?\d+(?:\.\d*)?)|(?:(?:[+-]?\d+(?:\.\d*)?)-(?:[+-]?\d+(?:\.\d*)?))|(?:(?:[+-]?\d+(?:\.\d*)?)[+-])
type: string
- name: field
in: query
description: Recipe fields to be included in the response.
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- uri
- label
- image
- images
- source
- url
- shareAs
- yield
- dietLabels
- healthLabels
- cautions
- ingredientLines
- ingredients
- calories
- glycemicIndex
- inflammatoryIndex
- totalCO2Emissions
- co2EmissionsClass
- totalWeight
- totalTime
- cuisineType
- mealType
- dishType
- totalNutrients
- totalDaily
- digest
- tags
- externalId
- name: co2EmissionsClass
in: query
description: Filter recipes by their CO2 footprint.
schema:
type: string
enum:
- A+
- A
- B
- C
- D
- E
- F
- G
- name: tag
in: query
description: Show only recipes containing the specified tags.
explode: true
schema:
type: array
items:
type: string
- name: sysTag
in: query
description: |
_(Beta)_ Show only recipes containing the specified system tags. This field is subject to account
subscription restrictions.
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- live
- name: Accept-Language
description: Search recipes in the specified language.
in: header
schema:
type: string
default: en
responses:
'200':
description: A list of recipes
headers:
Content-Language:
schema:
type: string
description: The localization language.
content:
application/json:
schema:
$ref: '#/components/schemas/Response'
'400':
description: A list of errors
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: A list of errors
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
/api/recipes/v2/by-uri:
get:
tags:
- Recipe Search
security:
- app_id: []
app_key: []
Edamam-Account-User: []
- basic: []
Edamam-Account-User: []
summary: Lookup Recipe(s) using their URI(s)
description: |
Search for recipes by their URI. Note, that the API response doesn't directly indicate if there are missing
recipes. Instead, you need to compare he URIs to see if any are missing.
parameters:
- name: type
in: query
description: This parameter is no longer used. It's kept here for backwards compatibility.
required: false
schema:
type: string
enum:
- public
- user
- edamam-generic
- name: beta
in: query
description: Allow beta features in the request and response
schema:
type: boolean
- name: uri
in: query
description: Recipe URIs - up to 20
required: true
explode: true
schema:
type: array
minItems: 1
maxItems: 20
items:
type: string
- name: field
in: query
description: Recipe fields to be included in the response.
explode: true
schema:
type: array
uniqueItems: true
items:
type: string
enum:
- uri
- label
- image
- images
- source
- url
- shareAs
- yield
- dietLabels
- healthLabels
- cautions
- ingredientLines
- ingredients
- calories
- glycemicIndex
- inflammatoryIndex
- totalCO2Emissions
- co2EmissionsClass
- totalWeight
- totalTime
- cuisineType
- mealType
- dishType
- totalNutrients
- totalDaily
- digest
- tags
- externalId
- name: Accept-Language
description: Search recipes in the specified language.
# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/edamam-recipes/refs/heads/main/openapi/edamam-recipe-search-v2-openapi.yml