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

List of the recipe's ingredients

ingredientLines

[String]

Complete ingredient lines including quantity

E.g. 1/4 cup coconut oil, melted

parsedIngredientLines

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 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

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

Nutritional information per gram of recipe. For most use cases, the nutrientsPerServing object should be preferred.

nutrientsPerServing

Nutritional information per serving

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

Relative caloric value of each macronutrient as a percentage of total calories per serving.

Simple Example

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

Full Example

{
  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
    }
  }
}

Last updated