Recipe Objects

The Recipe Object is composed of root-level attributes, some of which are objects by themselves.

Recipe Data Dictionary

ATTRIBUTE

TYPE

DESCRIPTION

id

string

name

string

description

string

numberOfServings

number

Original number of servings

numberOfServingsScaled

number

Requested number of servings

normalizedIngredients

ingredients

array [RawIngredient]

instructions

RecipeInstructions

images

array [ImageContainer]

videos

array [VideoContainer]

source

RecipeSource

durations

RecipeDurations

labels

RecipeLabels

nutrition

RecipeNutrition

constraints

RecipeConstraints

saved

RecipeSaved

This field is populated if fields=saved is added to request parameters

author

RecipeAuthor

RecipeNutrition

ATTRIBUTE

TYPE

DESCRIPTION

total

An array of nutrients for the entire recipe

labels

array [RecipeLabel]

​Content

healthScore

glycemicIndex

glycemicLoad

Nutrient

ATTRIBUTE

TYPE

DESCRIPTION

code

enum

label

string

A readable name e.g. Energy, Total Fat etc.

value

integer

The nutrient's value

unit

enum

Possible values: g, mg, µg, kcal

HealthScore

ATTRIBUTE

TYPE

DESCRIPTION

value

double

​Content

nutrientsInfluence

Components which influence health score

NutrientsInfluence

ATTRIBUTE

TYPE

DESCRIPTION

code

string

​Content

influence

double

​Content

comment

string

​Content

GlycemicScore

ATTRIBUTE

TYPE

DESCRIPTION

value

double

​Content

NormalizedIngredient

ATTRIBUTE

TYPE

DESCRIPTION

text

string

​Content

group

string

​Content

analysis

​Content

RecipeIngredientAnalysis

ATTRIBUTE

TYPE

DESCRIPTION

product

string

​Content

canonicalName

string

​Content

quantity

number

​Content

unit

string

​Content

multiplier

number

​Content

brand

string

​Content

comment

string

​Content

category

string

​Content

ProductCategory

ATTRIBUTE

TYPE

DESCRIPTION

name

string

​Content

ImageContainer

ATTRIBUTE

TYPE

DESCRIPTION

url

string

original image url, depricated. Please use field original instead

original

OriginalImage

original image information, e.g. image url

responsive

​Content

ResponsiveImage

ATTRIBUTE

TYPE

DESCRIPTION

url

string

Hosted url of an image

width

integer

Image width

height

integer

Image height

RecipeSource

ATTRIBUTE

TYPE

DESCRIPTION

name

string

​Content

displayName

string

​Content

sourceRecipeUrl

string

​Content

license

string

​Content

image

ImageContainer

​Content

RecipeLabels

ATTRIBUTE

TYPE

DESCRIPTION

mealType

​Content

cuisine

​Content

category

​Content

RecipeLabel

ATTRIBUTE

TYPE

DESCRIPTION

name

string

​Content

displayName

string

​Content

RecipeDurations

ATTRIBUTE

TYPE

DESCRIPTION

cookTime

number

Cooking time in minutes

prepTime

number

Preparation time in minutes

totalTime

number

Total time in minutes

Nutrition Labels

We provide a batch of labels based on nutrition information.

Available nutrition labels

  • Low Energy

  • Energy Free

  • Low Fat

  • Fat Free

  • Low Saturated Fat

  • Saturated Fat Free

  • Low Sugars

  • Sugars Free

  • Low Sodium

  • Very Low Sodium

  • Sodium Free

  • Low Salt

  • Very Low Salt

  • Salt Free

  • Cholesterol Free

  • Low Cholesterol

  • Source Of Fiber

  • High Fiber

  • Source Of Protein

  • High Protein

  • High Monounsaturated Fat

  • High Polyunsaturated Fat

  • Hight Unsaturated Fat

Also labels for each vitamin and mineral presented in nutrition info:

  • Source Of ...

  • High ...

e.g. Source Of Calcium or Hight Vitamin A

{
  "id": "9773cb7eca5d11e7ae7e42010a9a0035",
  "name": "Omelette pancakes with tomato & pepper sauce",
  "description": "Healthy, low-calorie and gluten-free - these herby egg 'pancakes' will become your go-to favourite for a quick midweek meal",
  "ingredients": [
    {
      "text": "4 large eggs"
    },
    {
      "text": "handful basil leaves"
    },
    {
      "text": "2 tsp rapeseed oil, plus a little extra for the pancakes"
    },
    {
      "text": "1 yellow pepper, quartered, deseeded and thinly sliced"
    },
    {
      "text": "2 garlic cloves, thinly sliced"
    },
    {
      "text": "1 tbsp cider vinegar"
    },
    {
      "text": "400g can chopped tomatoes"
    },
    {
      "text": "wholemeal bread or salad leaves, to serve"
    }
  ],
  "images": [
    {
      "url": "https://www.bbcgoodfood.com/sites/default/files/styles/recipe/public/recipe_images/omelette-pancakes-with-tomato-pepper-sauce.jpg",
      "responsive": {
        "url": "https://whisk-res.cloudinary.com/image/upload/v1523012138/recipe/758058656142eaae402f1781e18c527c.jpg",
        "width": 454,
        "height": 500
      }
    }
  ],
  "videos": [],
  "source": {
    "name": "bbcgoodfood.com",
    "displayName": "BBC Good Food",
    "sourceRecipeUrl": "https://www.bbcgoodfood.com/recipes/omelette-pancakes-tomato-pepper-sauce",
    "license": "Fairuse",
    "image": {
      "url": "https://whisk-res.cloudinary.com/image/upload/publishers/logos/bbcgoodfood-logo.png",
      "responsive": {
        "url": "https://whisk-res.cloudinary.com/image/upload/publishers/logos/bbcgoodfood-logo.png",
        "width": 256,
        "height": 256
      }
    }
  },
  "numberOfServings": 2,
  "durations": {
    "cookTime": 20,
    "prepTime": 10,
    "totalTime": 30
  },
  "nutrition": {
    "status": "Available",
    "total": [
      {
        "label": "Sugars",
        "code": "SUGAR",
        "value": 18.032,
        "unit": "G"
      },
      ...
    ],
    "labels": [
      {
        "name": "low-saturated-fat",
        "displayName": "Low Saturated Fat"
      },
      ...
    ],
    "healthScore": {
      "value": 5.328398771869642,
      "nutrientsInfluence": [
        {
          "code": "FAT_UNSAT",
          "influence": 0.6939760843841576,
          "comment": "Medium positive impact"
        },
        ...
      ]
    },
    "glycemicIndex": {
      "value": 41.37
    },
    "glycemicLoad": {
      "value": 9
    }
  },
  "labels": {
    "mealType": [
      {
        "name": "lunch",
        "displayName": "Lunch"
      },
      ...
    ],
    "cuisine": [
      {
        "name": "french",
        "displayName": "French"
      }
    ],
    "category": [
      {
        "name": "main-dishes",
        "displayName": "Main Dishes"
      },
      ...
    ],
    "technique": []
  },
  "constraints": {
    "violates": [
      "diets": [
        "lacto-vegetarian",
        "vegan"
      ],
      "avoidances": [
        "egg",
        "gluten",
        "yeast",
        "wheat"
      ]
    }
  },
  "author": {
    "name": "Sara Buenfeld"
  }
}

Last updated