Recipe

Fields and details of the recipe object

List of Fields

Please note that fields not documented here may be out of date or deprecated. Not finding what you are looking for? Shoot us an email.

Field	Type	Note
id	ID!	The recipe's id
databaseId	String	The database id of the recipe
totalTime	String	Total preparation and cooking time in text format E.g., 5 minutes
totalTimeInSeconds	Int	Total preparation and cooking time in seconds
name	String	Name of the recipe
numberOfServings	Int	Original recipe number of servings
ingredientsCount	Int	Quantity of ingredients in the recipe
ingredients	[Ingredient]	List of the recipe's ingredients
ingredientLines	[String]	Complete ingredient lines including quantity E.g. 1/4 cup coconut oil, melted
parsedIngredientLines	IngredientLine	Structured representation of the ingredient lines
language	String	Language code of the recipe
courses	[String]	Tags representing the courses associated with the recipe.
cuisines	[String]	Tags representing the cuisines associated with the recipe.
mealTags	String	Tags representing the meal of the day of the recipe. Options are: "Breakfast", "Lunch", "Dinner", "Snack", "Snacks", "Side dishes".
source	Source	Source information for the recipe, including the source's URL
mainImage	String	URL of recipe's main image
author	String	Recipe's author-name
authorAvatar	String	URL of the image representing the author of the recipe
adherence (deprecated)	Float	Adherence Score for the recipe
adherenceDetails	Adherence	Explain the recipe's Adherence Score and the reasoning behind it
isUserFavorite	Boolean	Has this recipe been marked as a favorite by the user
inUserShoppingList	Boolean	Is this recipe currently contained in the user's shopping list
weightInGrams	Float	Total weight of the recipe expressed in grams
servingWeight	Float	Weight, in grams, of each serving
isLogged	Boolean	True if the recipe has been recently logged by the requesting user
instructions	[String]	An array of cooking instruction lines. If this field is null then it means it is a "recipe from the internet" and you should redirect to the recipeURL in the source object.
nutritionalInfo	NutritionalInfo	Nutritional information per gram of recipe. For most use cases, the nutrientsPerServing object should be preferred.
nutrientsPerServing	nutrientsPerServing	Nutritional information per serving
caloriesPerServing	caloriesPerServing	Per serving caloric value of each nutrient
sourceUrlWorks (deprecated)	Boolean	True if the URL is working. Otherwise displays False. There are meal plans already created show recipes with URLs not working or invalid. This will help users to check recipes before rendering them to an external site.
externalId	String	Id of any external meal information which will help to associate the recipes in the external database with ours.
relativeCalories	RelativeCalories	Relative caloric value of each macronutrient as a percentage of total calories per serving.

Simple Example

Query

{
  recipe(id: "UmVjaXBlOmFmMDkzMjQ0LWZkZTMtNGE3Yy1iMTA4LWUxODExNTBkNmNiZQ==") {
    name
    author
    nutritionalInfo {
      calories
      protein
      carbs
      fat
    }
  }
}

Response

{
  "data": {
    "recipe": {
      "name": "Tropical Storm Detox Shake",
      "author": "Dr. William Davis",
      "nutritionalInfo": {
        "calories": 1.48,
        "protein": 0.01,
        "carbs": 0.09,
        "fat": 0.13
      }
    }
  }
}

Full Example

Query

{
  recipe(id: "UmVjaXBlOjA2YjM1ODcwLTNlYTctNDYxZC1iZGMwLWIwNmY1ZGZmOTJhMw==") {
    databaseId
    totalTime
    totalTimeInSeconds
    name
    rating
    numberOfServings
    ingredientLines
    ingredients {
      name
    }
    language
    courses
    cuisines
    source {
      siteUrl
      displayName
      recipeUrl
    }
    mainImage
    isPremium
    isFeatured
    author
    authorAvatar
    ingredientsCount
    favoritesCount
    isUserFavorite
    inUserShoppingList
    weightInGrams
    servingWeight
    isLogged
    relativeCalories {
      carbs
      fat
      protein
      fat
    }
    instructions
    nutritionalInfo {
      calories
      protein
      carbs
      fat
      sugar
      fiber
      saturatedFat
      monounsaturatedFat
      polyunsaturatedFat
      transFat
      cholesterol
      sodium
      potassium
      vitaminA
      vitaminC
      calcium
      iron
      netcarbs
    }
  }
}

Response

{
  "data": {
    "recipe": {
      "databaseId": "06b35870-3ea7-461d-bdc0-b06f5dff92a3",
      "totalTime": "30 minutes",
      "totalTimeInSeconds": 1800,
      "name": "Garlic-Seafood Stew",
      "rating": null,
      "numberOfServings": 2,
      "ingredientLines": [
        "1 tbsp olive oil",
        "1 small onion, diced",
        "5 garlic cloves, minced",
        "14 oz can diced tomatoes",
        "1 cup clam juice",
        "1 bay leaf",
        "1 tsp salt",
        "5 oz clams",
        "6 oz mussels",
        "4 oz shrimp, peeled and deveined",
        "3 oz calamari, sliced into rings",
        "2 tbsp chopped parsley"
      ],
      "ingredients": [
        {
          "name": "Olive oil"
        },
        {
          "name": "Onion"
        },
        {
          "name": "Garlic cloves"
        },
        {
          "name": "Tomatoes"
        },
        {
          "name": "Clam juice"
        },
        {
          "name": "Bay leaf"
        },
        {
          "name": "Salt"
        },
        {
          "name": "Clam"
        },
        {
          "name": "Mussels"
        },
        {
          "name": "Shrimp"
        },
        {
          "name": "Calamari"
        },
        {
          "name": "Parsley"
        }
      ],
      "language": null,
      "courses": [],
      "cuisines": null,
      "source": null,
      "mainImage": "https://storage.googleapis.com/sg-uploads/a97716f2e53c45c4be16d617de6c98e8.jpg",
      "isPremium": null,
      "isFeatured": null,
      "author": "Suggestic Premium",
      "authorAvatar": "https://sg-data.storage.googleapis.com/author/suggestic-premium.png",
      "ingredientsCount": 12,
      "favoritesCount": 1,
      "isUserFavorite": false,
      "inUserShoppingList": false,
      "weightInGrams": 1359.48474,
      "servingWeight": 679.74237,
      "isLogged": false,
      "relativeCalories": {
        "carbs": 0.2728,
        "fat": 0.2892,
        "protein": 0.438
      },
      "instructions": [
        "In a large stock pot, heat oil over medium high heat. Add the onions and cook for 3 minutes. Add garlic and saute for another minute.",
        "Add 1 cup of water, tomatoes, clam juice, bay leaf and salt. Bring to a boil, then reduce heat to medium and simmer for 20 minutes.",
        "Add in all the seafood at once and stir to combine. Cook until shrimp is pink and cooked through and mussels and clams have opened, about 7 minutes.",
        "Garnish with parsley and serve immediately"
      ],
      "nutritionalInfo": {
        "calories": 0.5185,
        "protein": 0.0568,
        "carbs": 0.0354,
        "fat": 0.0167,
        "sugar": 0.0126,
        "fiber": 0.0035,
        "saturatedFat": 0.0024,
        "monounsaturatedFat": 0.0081,
        "polyunsaturatedFat": 0.0021,
        "transFat": 0,
        "cholesterol": 0.3353,
        "sodium": 3.6826,
        "potassium": 1.2871,
        "vitaminA": 0,
        "vitaminC": 0.2328,
        "calcium": 0.2102,
        "iron": 0.0111,
        "netcarbs": 0.03
      }
    }
  }
}