Recipes

Important

This is an experimental feature. If you are interested in exploring its capabilities, please ask your Account Manager to enable it for your site.

Our Drafts and Posts API support nutrition facts calculations based on the provided recipe information.

Whenever a draft or a post is saved or updated, a schema-less field named roar_specific_data is checked. If the featured is enabled and the following parameters are received, our APIs will automatically parse your recipe data and will compute the recipe’s nutrition facts.

Parameters

Name Type Description
ingredients String Ingredients text, each line is considered as one ingredient - Required
servings Integer Servings - Optional - Defaults to 1

Request example

As an example, here is a recipe from our client MyRecipeMagic: https://www.myrecipemagic.com/grilled-chicken-marinade-2639881057.html

The parameters described above should be sent as part of the payload for creating/updating drafts/posts as follows:

{
    "headline": "My first recipe",
    "roar_specific_data": {
        "servings": 8,
        "ingredients": "2 cups 7-Up - Don't use the diet stuff! \r\n1 cup Soy Sauce \r\n1\/2 cup vegetable oil \r\n1\/2 tablespoon horseradish \r\n1\/2 teaspoon garlic powder \r\n6-8 skinless ( boneless chicken breasts ) "
    }
}

Response

The response payload will contain all of the post’s information, but for the purposes of this example we are going to deal with the roar_specific_data field only.

This field is used to store parsed information of ingredients and nutrition facts data.

Name Type Description
ingredients_parsed Array of Objects Parsed information of ingredients
nutrition_facts Object Nutrition facts information

Ingredient parsed

Name Type Description
quantity Float Quantity
fraction Float Fraction
measurement Integer Measurement
name String Name
comment String Comment

Nutrition facts

Nutrition facts are returned in a single object, which has a form of a map of code to nutrition fact object. Here are the details:

Name Type Description
description String Description
value Float Value
measurement String Measurement
dec Float Decagrams
group String Group

Response Example

{
    ...
    "roar_specific_data": {
        "servings": 8,
        "ingredients": "2 cups 7-Up - Don't use the diet stuff! \r\n1 cup Soy Sauce \r\n1/2 cup vegetable oil \r\n1/2 tablespoon horseradish \r\n1/2 teaspoon garlic powder \r\n6-8 skinless ( boneless chicken breasts ) ",
        "ingredients_parsed": [{
            "comment": "None",
            "measurement": 4,
            "name": "7-up",
            "fraction": null,
            "quantity": 2.0
        }, {
            "comment": "None",
            "measurement": 4,
            "name": "soy sauce",
            "fraction": null,
            "quantity": 1.0
        }, {
            "comment": "None",
            "measurement": 4,
            "name": "vegetable oil",
            "fraction": 0.5,
            "quantity": 0
        }, {
            "comment": "None",
            "measurement": 2,
            "name": "horseradish",
            "fraction": 0.5,
            "quantity": 0
        }, {
            "comment": "None",
            "measurement": 1,
            "name": "garlic powder",
            "fraction": 0.5,
            "quantity": 0
        }, {
            "comment": "boneless chicken breasts",
            "measurement": null,
            "name": "boneless skinless chicken breast",
            "fraction": null,
            "quantity": 6.0
        }],
        "nutrition_facts": {
            "Niacin": {
                "dec": 2,
                "group": "6",
                "description": "Niacin",
                "value": 3.65,
                "measurement": "mg"
            },
            "Sodium": {
                "dec": 0,
                "group": "6",
                "description": "Sodium",
                "value": 2033.0,
                "measurement": "mg"
            },
            "FatPoly": {
                "dec": 2,
                "group": "2",
                "description": "Polysaturated Fat",
                "value": 1.27,
                "measurement": "g"
            },
            "Thiamin": {
                "dec": 2,
                "group": "6",
                "description": "Thiamin",
                "value": 0.79,
                "measurement": "mg"
            },
            "Sugar": {
                "dec": 1,
                "group": "5",
                "description": "Sugar",
                "value": 6.199999999999999,
                "measurement": "g"
            },
            "B12": {
                "dec": 2,
                "group": "7",
                "description": "Vitamin B12",
                "value": 1.2000000000000002,
                "measurement": "Ug"
            },
            "Fiber": {
                "dec": 1,
                "group": "5",
                "description": "Fiber",
                "value": 1.3,
                "measurement": "g"
            },
            "FatSat": {
                "dec": 2,
                "group": "2",
                "description": "Saturated Fat",
                "value": 12.26,
                "measurement": "g"
            },
            "Potassium": {
                "dec": 0,
                "group": "6",
                "description": "Potassium",
                "value": 127.0,
                "measurement": "mg"
            },
            "VitD": {
                "dec": 1,
                "group": "7",
                "description": "Vitamin D",
                "value": 0,
                "measurement": "Ug"
            },
            "Carbs": {
                "dec": 1,
                "group": "5a",
                "description": "Carbohydrates",
                "value": 8.699999999999998,
                "measurement": "g"
            },
            "TotalFat": {
                "dec": 2,
                "group": "2a",
                "description": "Total Fat",
                "value": 16.51,
                "measurement": "g"
            },
            "Calories": {
                "dec": 0,
                "group": "1",
                "description": "Calories",
                "value": 201.0,
                "measurement": ""
            },
            "FolicAcid": {
                "dec": 1,
                "group": "6",
                "description": "Folic Acid",
                "value": 1.3,
                "measurement": "Ug"
            },
            "VitK": {
                "dec": 1,
                "group": "7",
                "description": "Vitamin K",
                "value": 3.3,
                "measurement": "Ug"
            },
            "Calcium": {
                "dec": 0,
                "group": "6",
                "description": "Calcium",
                "value": 11.0,
                "measurement": "mg"
            },
            "Riboflavin": {
                "dec": 2,
                "group": "6",
                "description": "Riboflavin",
                "value": 0.8300000000000001,
                "measurement": "mg"
            },
            "Iron": {
                "dec": 2,
                "group": "6",
                "description": "Iron",
                "value": 1.2399999999999998,
                "measurement": "mg"
            },
            "Cholesterol": {
                "dec": 2,
                "group": "6",
                "description": "Cholesterol",
                "value": 14.57,
                "measurement": "mg"
            },
            "VitC": {
                "dec": 1,
                "group": "7",
                "description": "Vitamin C",
                "value": 1.5,
                "measurement": "mg"
            },
            "VitA": {
                "dec": 0,
                "group": "7",
                "description": "Vitamin A",
                "value": 18.0,
                "measurement": "IU"
            },
            "VitE": {
                "dec": 2,
                "group": "7",
                "description": "Vitamin E",
                "value": 0.56,
                "measurement": "mg"
            },
            "FatMono": {
                "dec": 2,
                "group": "2",
                "description": "Monosaturated Fat",
                "value": 2.9800000000000004,
                "measurement": "g"
            },
            "VitB6": {
                "dec": 2,
                "group": "7",
                "description": "Vitamin B6",
                "value": 0.94,
                "measurement": "mg"
            },
            "Zinc": {
                "dec": 1,
                "group": "6",
                "description": "Zinc",
                "value": 0.5,
                "measurement": "mg"
            },
            "Protein": {
                "dec": 1,
                "group": "4",
                "description": "Protein",
                "value": 8.3,
                "measurement": "g"
            }
        }
    },
    ...
}