Technical Docs
Ask or search…
K

Equivalent Recipes (Macros)

Query to obtain recipes with similar macronutrient distribution
Use the similarMacrosRecipes query to obtain recipes equivalent in macronutrient distribution as the one provided in the argument. Use the size argument to indicate the number of recipes returned.
If you already have a meal from a mealPlan query, you can use the serving argument to find more recipes. The recipes in the response will also have a serving field to know how many of the total numbers of servings have to be served to keep a similar amount of macros.
Arguments
Type
Required
Description
recipeId
ID
True
Recipe to which equivalents are to be returned
serving
Int
False
The number of recipe servings served. Default to 1.
size
Int
False
Define the number of returned recipes.
If this parameter is not sent, the default number is 3.

Example

The following example returns recipes equivalent to the recipe ID provided in the argument. Since the size parameter is not defined, by default, the number of recipes retrieved is 3.
Query
Response
{
similarMacrosRecipes(
recipeId: "UmVjaXBlOjZlZDUyNGFmLWVhNTMtNDJhMi05ODEzLTc1MDQzMDNkNjc4Yw=="
serving: 2
) {
id
name
serving
numberOfServings
nutrientsPerServing {
calories
carbs
fat
protein
}
}
}
{
"data": {
"similarMacrosRecipes": [
{
"id": "UmVjaXBlOjI0ODBlMTZhLTBhOTUtNDAzOC05YmJhLTBmZTAxZDE3YTI3NQ==",
"name": "Banana Chai Spice Smoothie",
"serving": 2,
"numberOfServings": 3,
"nutrientsPerServing": {
"calories": 362.58,
"carbs": 56.83,
"fat": 9.43,
"protein": 12.6
}
},
{
"id": "UmVjaXBlOjExNjFiOTIxLTcyNGEtNDk0YS1hMWZkLThlYzAxYTczYTgxYg==",
"name": "Baked Oatmeal With Dried Fruit",
"serving": 1,
"numberOfServings": 1,
"nutrientsPerServing": {
"calories": 336.31,
"carbs": 48.94,
"fat": 9.94,
"protein": 12.77
}
},
{
"id": "UmVjaXBlOjc3MTg2ZTIzLTYzMDktNDQ5Mi05NDA1LWIxN2IwMDNjMmFkMg==",
"name": "Quinoa Salad With Black Beans And Mango",
"serving": 2,
"numberOfServings": 4,
"nutrientsPerServing": {
"calories": 348.72,
"carbs": 55.18,
"fat": 8.74,
"protein": 12.34
}
}
]
}
}
The following example retrieves 15 similar recipes:
Query
Response
{
similarMacrosRecipes(
recipeId: "UmVjaXBlOjZlZDUyNGFmLWVhNTMtNDJhMi05ODEzLTc1MDQzMDNkNjc4Yw=="
serving: 2
size: 15
) {
id
name
serving
numberOfServings
nutrientsPerServing {
calories
carbs
fat
protein
}
}
}
{
"data": {
"similarMacrosRecipes": [
{
"id": "UmVjaXBlOjdjYzA3YWExLTM2OWYtNDk5Ny04NWEyLWFhZWRkMzE2N2JlNA==",
"name": "Masala Dosa",
"serving": 1,
"numberOfServings": 3,
"nutrientsPerServing": {
"calories": 500.84,
"carbs": 78.13,
"fat": 12.97,
"protein": 17.91
}
},
{
"id": "UmVjaXBlOmU5MWMwODNkLTFkNGMtNDg0ZS1hZWVjLWMzOGE1Y2E5NTI3Nw==",
"name": "Make Perfect Gnocchi At Home",
"serving": 2,
"numberOfServings": 2,
"nutrientsPerServing": {
"calories": 282.29,
"carbs": 41.14,
"fat": 9.8,
"protein": 7.39
}
},
{
"id": "UmVjaXBlOjhmNGRkYmUyLTA2MzMtNGVkOS04ZWQyLTgwMDUzMmJmMGQ1NA==",
"name": "One Pot Lemon Herb Chicken And Rice",
"serving": 2,
"numberOfServings": 4,
"nutrientsPerServing": {
"calories": 272.54,
"carbs": 41.84,
"fat": 7.87,
"protein": 8.59
}
},
{
"id": "UmVjaXBlOjYyZGJlY2UwLTA1YjYtNDNiYy1iOTFiLWI1NDE1Mjk2NzljOA==",
"name": "Creamless Creamed Corn With Mushrooms And Lemon",
"serving": 2,
"numberOfServings": 4,
"nutrientsPerServing": {
"calories": 276.06,
"carbs": 41.04,
"fat": 9.28,
"protein": 7.09
}
},
{
"id": "UmVjaXBlOmFlOGMwYmIyLTg1NjItNDY2MC04ZTYwLTE4NzA3M2NiZTMxOA==",
"name": "Pasta All’Arrabbiata",
"serving": 4,
"numberOfServings": 4,
"nutrientsPerServing": {
"calories": 114.76,
"carbs": 18.2,
"fat": 3.29,
"protein": 3.09
}
},
{
"id": "UmVjaXBlOjZmZjgzNmZkLWJkN2UtNDg2YS1hZjg1LTliZDI1ODM5OTNhNA==",
"name": "Toasted Orzo With Olives And Lemon",
"serving": 2,
"numberOfServings": 8,
"nutrientsPerServing": {
"calories": 275.88,
"carbs": 42.4,
"fat": 8.59,
"protein": 7.23
}
},
{
"id": "UmVjaXBlOmFjMGZiMGU0LWEzMjgtNGM1ZC04ZDM0LWU0MDgxNjc5ZTM2Mg==",
"name": "Spinach Tagliatelle With Sesame And Cherry Tomatoes",
"serving": 1,
"numberOfServings": 2,
"nutrientsPerServing": {
"calories": 567.28,
"carbs": 88.62,
"fat": 15.56,
"protein": 18.18
}
},
{
"id": "UmVjaXBlOmFkM2Q2YzZkLTJhNDAtNDNmMi04N2I5LTE2ZTA0OWUyY2E2NA==",
"name": "Buckwheat Porridge With Green Beans",
"serving": 1,
"numberOfServings": 3,
"nutrientsPerServing": {
"calories": 547.51,
"carbs": 83.22,
"fat": 17.08,
"protein": 15.23
}
},
{
"id": "UmVjaXBlOjA5NWUyMDIwLTM5Y2UtNGU5ZC05MTAxLTYyMjgyNjlkMTgxYw==",
"name": "Lamb Carpaccio With Figs, Green Olives And Mint",
"serving": 4,
"numberOfServings": 6,
"nutrientsPerServing": {
"calories": 142.39,
"carbs": 22.62,
"fat": 4.05,
"protein": 3.87
}
},
{
"id": "UmVjaXBlOjcwNWJkMTMzLTMzNWUtNDA3Yi1iZDg2LTdmODk0NDRkM2FkYQ==",
"name": "Pumpkin-Walnut And Spinach Pasta",
"serving": 1,
"numberOfServings": 3,
"nutrientsPerServing": {
"calories": 533.99,
"carbs": 74.18,
"fat": 17.69,
"protein": 19.52
}
},
{
"id": "UmVjaXBlOjk5ZGFhYzAyLWE3MWYtNDIyNy04ZGNkLTYwNjQwZjVmZjdmYg==",
"name": "Purple Sweet Potato Soup With Cauliflower",
"serving": 1,
"numberOfServings": 2,
"nutrientsPerServing": {
"calories": 512.62,
"carbs": 75.36,
"fat": 14.94,
"protein": 19.17
}
},
{
"id": "UmVjaXBlOjkwNzZjYTI1LTQ2NDctNDdhMy04ZjkxLTg4YzI3NTlkZDYwZA==",
"name": "Mushroom Rice Pilaf",
"serving": 2,
"numberOfServings": 7,
"nutrientsPerServing": {
"calories": 255.1,
"carbs": 42.48,
"fat": 6.59,
"protein": 6.47
}
},
{
"id": "UmVjaXBlOjFkMWI4NDlkLTQyNzUtNDhlYy04MmFhLTcyNjk4ZTVlYjllMg==",
"name": "Thai Omelette With Rice",
"serving": 1,
"numberOfServings": 2,
"nutrientsPerServing": {
"calories": 604.73,
"carbs": 96.81,
"fat": 15.21,
"protein": 20.14
}
},
{
"id": "UmVjaXBlOmU5NjA2MjI1LTI4ZTktNGEzMi05MzgxLWE3NjMwZTZlODJjZg==",
"name": "Paleo Crock Pot Beef Stew",
"serving": 3,
"numberOfServings": 7,
"nutrientsPerServing": {
"calories": 208.72,
"carbs": 31.24,
"fat": 6.07,
"protein": 7.27
}
},
{
"id": "UmVjaXBlOmE3YTU3YzcxLThmOTQtNDM4NC05ZGJjLTJiM2M1ODFhYmI0Mw==",
"name": "Stracciatella Pasta With Summer Squash, Burrata Cheese And Bread Crumbs",
"serving": 3,
"numberOfServings": 4,
"nutrientsPerServing": {
"calories": 176.84,
"carbs": 28.23,
"fat": 3.99,
"protein": 6.99
}
}
]
}
}