Get Recipe

Gets recipe information by the recipe identifier or by URL

Get Recipe

GET https://graph.whisk.com/v1/:id

Path Parameters

NameTypeDescription

id

string

Recipe Id or URL. (can be path or query param id)

fields

array

Extra fields to return on recipe. The options are: normalizedIngredients, instructions, nutrition, saves

userId

string

Allows to get information if this recipe is saved to favorites

servings

number

Scale normalizedIngredients amounts to requested number of servings

scale

number

Multiplier for ingredients amounts in recipe: 0.5, 2, ...

{
  "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"
      },
      {
        "label": "Energy",
        "code": "ENERC_KCAL",
        "value": 552.149,
        "unit": "Kcal"
      },
      {
        "label": "Vitamin K",
        "code": "VITK1",
        "value": 67.71400000000001,
        "unit": "Mkg"
      },
      {
        "label": "Carbohydrate Total",
        "code": "CHOCDF",
        "value": 43.497,
        "unit": "G"
      },
      {
        "label": "Riboflavin B2",
        "code": "RIBF",
        "value": 0.8960000000000001,
        "unit": "Mg"
      },
      {
        "label": "Thiamin B1",
        "code": "THIA",
        "value": 0.256,
        "unit": "Mg"
      },
      {
        "label": "Iron",
        "code": "Fe",
        "value": 8.199,
        "unit": "Mg"
      },
      {
        "label": "Magnesium",
        "code": "MG",
        "value": 62.458000000000006,
        "unit": "Mg"
      },
      {
        "label": "Monounsaturated Fat",
        "code": "FAMS",
        "value": 12.365999999999998,
        "unit": "G"
      },
      {
        "label": "Niacin B3",
        "code": "NIA",
        "value": 2.0069999999999997,
        "unit": "Mg"
      },
      {
        "label": "Potassium",
        "code": "K",
        "value": 1547.69,
        "unit": "Mg"
      },
      {
        "label": "Saturated Fat",
        "code": "FASAT",
        "value": 6.438,
        "unit": "G"
      },
      {
        "label": "Calcium",
        "code": "CA",
        "value": 185.481,
        "unit": "Mg"
      },
      {
        "label": "Total Fat",
        "code": "FAT",
        "value": 27.037000000000006,
        "unit": "G"
      },
      {
        "label": "Sodium",
        "code": "NA",
        "value": 1430.048,
        "unit": "Mg"
      },
      {
        "label": "Cholesterol",
        "code": "CHOLE",
        "value": 654.72,
        "unit": "Mg"
      },
      {
        "label": "Vitamin A",
        "code": "VITA_RAE",
        "value": 1004.706,
        "unit": "Mkg"
      },
      {
        "label": "Folic Acid B9",
        "code": "FOL",
        "value": 113.88000000000001,
        "unit": "Mkg"
      },
      {
        "label": "Polyunsaturated Fat",
        "code": "FAPU",
        "value": 6.467999999999999,
        "unit": "G"
      },
      {
        "label": "Phosphorus",
        "code": "P",
        "value": 444.51200000000006,
        "unit": "Mg"
      },
      {
        "label": "Zinc",
        "code": "Zn",
        "value": 3.0579999999999994,
        "unit": "Mg"
      },
      {
        "label": "Protein",
        "code": "PROCNT",
        "value": 30.446000000000005,
        "unit": "G"
      },
      {
        "label": "Vitamin C",
        "code": "VITC",
        "value": 129.308,
        "unit": "Mg"
      },
      {
        "label": "Vitamin B12",
        "code": "VITB12",
        "value": 1.566,
        "unit": "Mkg"
      },
      {
        "label": "Vitamin B6",
        "code": "VITB6A",
        "value": 0.715,
        "unit": "Mg"
      },
      {
        "label": "Fiber",
        "code": "FIBTG",
        "value": 10.701,
        "unit": "G"
      },
      {
        "label": "Trans Fat",
        "code": "FATRN",
        "value": 0.10800000000000001,
        "unit": "G"
      },
      {
        "label": "Vitamin E",
        "code": "TOCPHA",
        "value": 4.6659999999999995,
        "unit": "Mg"
      },
      {
        "label": "Vitamin D",
        "code": "VITD",
        "value": 3.608,
        "unit": "Mkg"
      }
    ],
    "labels": [
      {
        "name": "low-saturated-fat",
        "displayName": "Low Saturated Fat"
      },
      {
        "name": "high-monounsaturated-fat",
        "displayName": "High Monounsaturated Fat"
      },
      {
        "name": "source-of-vitamin-a",
        "displayName": "Source Of Vitamin A"
      },
      {
        "name": "low-sugars",
        "displayName": "Low Sugars"
      },
      {
        "name": "source-of-protein",
        "displayName": "Source Of Protein"
      },
      {
        "name": "high-protein",
        "displayName": "High Protein"
      },
      {
        "name": "source-of-vitamin-c",
        "displayName": "Source Of Vitamin C"
      },
      {
        "name": "diabetes-friendly",
        "displayName": "Diabetes Friendly"
      }
    ],
    "healthScore": {
      "value": 5.328398771869642,
      "nutrientsInfluence": [
        {
          "code": "FAT_UNSAT",
          "influence": 0.6939760843841576,
          "comment": "Medium positive impact"
        },
        {
          "code": "SUGAR",
          "influence": -0.16607094540196313,
          "comment": "Low negative impact"
        },
        {
          "code": "CHOCDF",
          "influence": -0.32233080518343327,
          "comment": "Low negative impact"
        },
        {
          "code": "Fe",
          "influence": 0.7959836140700944,
          "comment": "Strong positive impact"
        },
        {
          "code": "MG",
          "influence": 0.42528069107651134,
          "comment": "Medium positive impact"
        },
        {
          "code": "K",
          "influence": 0.5341771359436212,
          "comment": "Medium positive impact"
        },
        {
          "code": "FASAT",
          "influence": -0.20384433830804286,
          "comment": "Low negative impact"
        },
        {
          "code": "CA",
          "influence": 0.4175784374308489,
          "comment": "Medium positive impact"
        },
        {
          "code": "NA",
          "influence": -0.652384776600362,
          "comment": "Medium negative impact"
        },
        {
          "code": "CHOLE",
          "influence": -1,
          "comment": "Strong negative impact"
        },
        {
          "code": "VITA_RAE",
          "influence": 0.41592973912427417,
          "comment": "Medium positive impact"
        },
        {
          "code": "PROCNT",
          "influence": 0.661881064471508,
          "comment": "Medium positive impact"
        },
        {
          "code": "VITC",
          "influence": 0.723662907280685,
          "comment": "Medium positive impact"
        },
        {
          "code": "FIBTG",
          "influence": 0.5679207239135912,
          "comment": "Medium positive impact"
        },
        {
          "code": "FATRN",
          "influence": -0.09403816166121269,
          "comment": "Insignificant impact"
        }
      ]
    },
    "glycemicIndex": {
      "value": 41.37
    },
    "glycemicLoad": {
      "value": 9
    }
  },
  "labels": {
    "mealType": [
      {
        "name": "lunch",
        "displayName": "Lunch"
      },
      {
        "name": "main-course",
        "displayName": "Main Course"
      },
      {
        "name": "dinner",
        "displayName": "Dinner"
      }
    ],
    "cuisine": [
      {
        "name": "french",
        "displayName": "French"
      }
    ],
    "category": [
      {
        "name": "main-dishes",
        "displayName": "Main Dishes"
      },
      {
        "name": "healthy-recipes",
        "displayName": "Healthy Recipes"
      },
      {
        "name": "lunch",
        "displayName": "Lunch"
      },
      {
        "name": "quick-and-easy",
        "displayName": "Quick and easy"
      },
      {
        "name": "dinner",
        "displayName": "Dinner"
      }
    ],
    "technique": []
  },
  "constraints": {
    "violates": [
      "diets": [
        "lacto-vegetarian",
        "vegan"
      ],
      "avoidances": [
        "egg",
        "gluten",
        "yeast",
        "wheat"
      ]
    }
  },
  "author": {
    "name": "Sara Buenfeld"
  }
}

Sample Request

curl "https://graph.whisk.com/v1/9773cb7eca5d11e7ae7e42010a9a0035?fields=nutrition" \
    -H "Accept: application/json" \
    -H "Authorization: Token <Access-Token>"

or

curl "https://graph.whisk.com/v1/?id=https:%2F%2Fwww.bbcgoodfood.com%2Frecipes%2Fomelette-pancakes-tomato-pepper-sauce;fields=nutrition" \
    -H "Accept: application/json" \
    -H "Authorization: Token <Access-Token>"

We highly optimized the speed of serving nutritional information for recipes, but for performance reasons, we still recommend including this field only when it is required. This can make the server respond faster with basic recipe data and have fewer data to transfer.

Last updated