Technical Docs
  • Introduction
  • Guides
    • Getting Started
    • Attribution Guidelines
    • Core Concepts
      • Adherence Score
      • Programs, Diets, and Rulesets
      • User Profile
      • Datasets
    • Tutorials and Walkthroughs
      • Creating a Meal Plan
      • Food Log Guide
      • Pagination
      • Executing Multiple Mutations
  • Knowledge Base
    • How-to guides
      • How to add desserts to your meal plan
      • How to log your custom recipe
      • How to generate a Meal Plan based on a template
    • Common errors
      • Meal Plan generation
    • FAQs
      • Getting Started on Suggestic
      • API and Authentication
      • Device Compatibility
      • Meal Plan
      • Nutrition
      • Programs
      • Recipes
  • HELPFUL RESOURCES
    • Deprecated Features
    • Glossary
    • Integrations
      • Building a No-code Meal Planning Application
        • Step 1: Creating the Integromat Scenario and Google Forms Connection
        • Step 2: Creating a User, Generating a Meal Plan, and Retrieving It
        • Step 3: Crafting Our PDF and Connecting PDFMonkey
        • Step 4: Sending The Document to Our User
  • Packages and SDKs
    • Node Package (NPM)
  • GraphQL
    • GraphQL Overview
    • Authentication
    • Calling GraphQL
    • GraphQL Playground
  • Changelog
    • 2025
      • March
  • Suggestic API Reference
    • Search
      • Food Log
        • Branded Foods Search
        • Common Foods Search
        • My Branded Food Search
        • My Common Foods Search
        • Food Search
        • Legacy
          • Autocomplete
          • Barcode Search
      • Recipe Search
        • Recipe Search
        • Recipe Search by Name or Ingredients
        • Recipe Search by Ingredients
      • Meal Plan Template Search
      • Profile Search
      • Restaurant Search
        • Restaurant Search by Location
        • Restaurant Search
    • Queries
      • Appointments
        • Upcoming Appointments
        • Past Appointments
        • Appointments Types
      • Assessments
        • Assessment Answers
        • Display Assessments
        • Supplement Recommendations
        • User Assessments
      • Content
        • Content Library
        • Content Categories
        • Content Tags
        • Journey
      • Food Log
        • Frequently Logged
        • Food Log Entries
        • Macros Aggregation
        • Micronutrients Aggregation
        • Macro Goals
        • Recently Logged
        • User's Foods and Recipes
          • User's Recipes
        • Legacy
          • Food Log Entries (Legacy)
          • Own Food Items
          • Own Food Item
          • Own Food Item by Id
          • Own Items
          • Own Recipe
          • Own Recipes
      • Lab Tests
        • Biomarker Categories
        • Biomarker Units
        • Biomarker Catalog
        • Biomarkers
        • Biomarker Results
        • Historical Biomarker Results
        • Historical Results by Biomarker
        • Lab Test Reports
        • Recommended Supplements
        • Recommended Articles
      • Meal Plan
        • Meal Plan
        • Custom Meal Plan
        • Simplified Meal Tracking
          • Meal Tracker
        • Meal Plan Config
        • Meal Planner (deprecated)
      • Program
        • All Programs
        • Program Details
      • Recipes
        • Equivalent Recipes (Macros)
        • Equivalent Recipes (Calories)
        • Recipe by Id
        • Recipes By MealTime
        • Recipes By Tag
        • Recipe Swap Options
        • Popular Recipes
        • Favorite Recipes
        • Premium Program Recipes
      • Restaurants
        • Restaurant By Id
        • Menu Items
        • Menu Item By Id
        • Menu Item by Program
        • Recommend Menu Items
      • Restrictions
        • Restrictions
        • Restriction by ID
      • Shopping List
        • Shopping List by Aisle
        • Shopping List by Recipes
      • Subscriptions
        • Subscription List
      • Supplement Plans
        • Supplement plan list
        • Supplement list
      • Tracking
        • Activity and Exercise
        • Checklists
          • Intake Checklist
        • Daily Recap
          • Get Daily Recap
          • Get Daily Recaps
          • Get Daily Recap Questions
          • Get Daily Mood Summary
        • Inisghts
        • Wellness Score
        • Sleep
          • Sleep Time
          • Sleep Quality Score
        • Steps
        • Water and Hydration
        • Heart Rate
        • HRV
        • Weight Tracker
      • USDA Food
      • Users
        • Users
        • User Profile
      • WGPT
        • Assistants
        • Journey
        • Guardrails
    • Mutations
      • Appointments
        • Update Appointment Credits
      • Assessments
        • New User Assessments
        • Set User Answers
      • Content
        • Mark Content as Read
      • Feedback
      • Food Log
        • Log Entries
          • Food Log
            • Add a Food Log Entry
            • Delete a Food Log Entry
          • Meal Log (Legacy)
            • Create Log Entry
            • Update Log Entry
            • Remove Log Entry
        • User's Foods and Recipes
          • Create a User Recipe
          • Create my Branded Food
          • Create my Common Foods
          • Update a User Recipe
          • Delete a User Recipe
          • Legacy: "Own" Recipe
            • Create "Own" Recipe
            • Update "Own" Recipe
            • Remove "Own" Recipe
        • AI Food Log
          • Process Ai Food
        • Legacy (ownFoods and ownRecipes)
          • Create "own" Food Item
          • Update "own Food"
          • Remove "own" Food Item
      • Journey Status
        • Start Journeys
        • Journey Status
        • Toggle Task Completed
      • Lab Tests
        • Add Biomarker
        • Update Biomarker
        • Add Biomarker Result
        • Add Biomarker Category
        • Update Biomarker Category
        • Remove Biomarker Category
        • Add Lab Test Report
        • Delete Lab Test Report
        • Update Lab Test Report
        • Create Recommended Supplement
        • Update Recommended Supplement
        • Remove Recommended Supplement
        • Create Recommended Article
        • Update Recommended Article
        • Remove Recommended Supplement
      • Meal Plan
        • Create Meal Plan Template
          • Custom Options
          • From Days
          • From Scratch
        • Assign a Meal Plan Template to a User
        • Generate Simple Meal Plan
        • Generate Meal Plan
        • Start Over Meal Plan
        • Swap Meals
        • Simplified Meal Tracking
          • Create a Meal Tracker Entry
        • Remove Meal Plan
        • Remove Meal Plan Recipe
      • Recipes
        • Add new recipe
        • Add Favorite Recipe
      • Shopping List
        • Add Multiple Recipes to the Shopping List
        • Add a Recipe to the Shopping List
        • Bulk Check/Uncheck Items
        • Check/Uncheck an Item
        • Clear Checked Items
        • Clear Shopping List
        • Remove Recipe
        • Update Serving Number
      • Subscriptions
        • Update Subscription
      • Supplement Plans
        • Create supplement plan for user
        • Update user supplement plan
        • Add Supplement
        • Update Supplement
      • Tracking
        • Activity and Exercise
          • Add Exercise Entry
          • Delete Exercise Entry
        • Checklists
          • Create my Checklist Item
          • Delete my Checklist Item
        • Daily Recap
          • Create a daily recap question
          • Select Daily Recap Questions
          • Delete a Daily Recap Question
        • Sleep
          • Add Sleep Time
          • Add Sleep Quality Score
        • Steps
          • Add Steps Count
          • Delete Steps Count
        • Heart Rate
          • Add Heart Rate
          • Delete Heart Rate
        • HRV
          • Add HRV
          • Delete HRV
        • Water and Hydration
        • Weight
          • Add Weight Entry
          • Remove Weight Entry
        • User Tracker Goals
          • Create User Goal
          • Update User Goal
          • Remove User Goal
      • Users
        • Authenticate using a Magic Link
        • Create User
        • Custom Attributes
        • Delete a User Account
        • Login User
        • Merge User Accounts
        • Request Reset Password
        • Reset Password
        • Request Password Reset email
        • Sensitive Profile Attributes
        • Update Profile
        • Update User's Program
        • User's Restrictions
        • Update Meal Plan Settings
        • User's Goals
        • Legacy User Mutations
          • Legacy | User's Biomarkers
          • User's Meal Plan Settings (deprecated)
      • WGPT
        • Add user to journey
  • Objects
    • Appointments
      • Appointment
      • Appointment Type
      • Appointment Credit
      • Attendee
      • Coach
    • Common
      • User
      • Adherence
      • Aisle Name
      • CPC
      • CPCIngredientGroup
      • Meal Times
      • Menu Item
      • Own Serving
      • Own Nutrients
      • MacroNutrientsRangeInput
      • Range
      • Tracker
      • Restaurant
    • Food Logs
      • Food Filter
      • Ingredient Amount
      • Ingredients
      • Own Recipe Ingredient
      • Meal Type
      • Nutrients
        • Nutrient Enum
      • Portions
      • Servings
      • AI Food Log
        • Food Analysis
    • Meal Plan
      • Debug Meal Plan Conditions
      • Meal
      • Meal Plan Day
      • Maximum Time per Meal
      • Maximum Ingredient Count
      • Meal Plan Template
      • Simple Meal Plan Filters
    • Recipe
      • Recipe
        • Tags
        • Cuisines
      • Recipe Swap Options
      • Parsed Ingredient Lines
      • Nutritional Info
      • Nutrients Per Serving
      • Calories Per Serving
      • Relative Calories
      • Source
      • Ingredients
      • Units of Measurement
    • Lab Tests
      • Article
      • Biomarker
    • Supplement
    • Assessments
      • Question
      • Answer
    • Content
      • Content Library
      • Content Categories
      • Content Tag
    • WGPT
      • Journey
      • dayJourney
      • Interaction
  • Case Studies
    • Reverse Health Case Study
Powered by GitBook
On this page
  • Available filters
  • Available Fields
  • Examples
  • Search by dietaryTag
  • Search by Macro Nutrients Ranges
  • Search by Ingredients
  • Search by Cuisine
  • Search with multiple filters and no query string
  • Search for more than one mealtime at the same time
  • Search for multiple ingredients and two mealtimes
  • Filter by number of servings
  • Filter by ingredient restriction

Was this helpful?

  1. Suggestic API Reference
  2. Search
  3. Recipe Search

Recipe Search

Search for recipes using a variety of filters

PreviousRecipe SearchNextRecipe Search by Name or Ingredients

Last updated 2 months ago

Was this helpful?

Use the recipeSearch query to find recipes that match the search query and a set of optional filters.

Available filters

  • -- to filter that search for recipes with the same amount of calories.

  • -- to filter to search recipes by using a specific dietary tags.

  • -- to filter to search recipes that contain one or more ingredients.

  • -- to filter to search recipes by using a variety of names.

  • -- to filter to search recipes by a determine meal time such as BREAKFAST, LUNCH, DINNER, SNACK or TREAT_DESSERT

  • -- to filter recipes that have instructions.

  • -- The filter object refines food results based on various criteria. It supports logical operators: must (AND) and should (OR). Additionally, the mustNot operator is available to exclude foods that match specific ingredients or tags.

This query doesn't automatically filter out recipes that "break" a user's restrictions or program, but you may use the recipe's field to do that. Alternatively, please refer to

Available Fields

Field

Type

Required

Description

query

String

False

Query string

dietaryTag

False

Possible Values: VEGETARIAN, VEGAN, PLANT_BASED, DAIRY_FREE, GLUTEN_FREE

first

Int

False

Quantity of results

maxPrepTime

Int

False

Maximum preparation time in minutes.

Filters out recipes with prep time longer than the value.

minPrepTime

Int

False

Minimum preparation time in minutes.

Filters out recipes with prep time lower than the value.

tags

[String]

False

List of tags

mealTime

RecipeMealTime

False

Meal of the day. Possible Values:BREAKFAST, LUNCH, DINNER, SNACK or TREAT_DESSERT

cuisines

False

numberOfIngredients

Int

False

Quantity of ingredients in the recipe

hasImage

Boolean

False

True if the recipe has an image

hasInstructions

Boolean

False

True if the recipe has instructions. Recipes "from the internet" do not have instructions.

Ingredients

False

List of ingredients

ingredientLines

String

False

macroNutrientsRange

False

Macro and micronutrient ranges

sourceUrlWorks

Boolean

False

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.

filter

false

Object that filters food according to different criteria. Use this object to filter more than one mealTime and multiple Ingredients.

servingQuantity

Int

false

Filter by the number of servings a recipe yields.

Examples

Search by dietaryTag

{
  recipeSearch(
    query: "pancakes"
    dietaryTag: GLUTEN_FREE
    first: 5
) {
    edges {
      node {
        name 
        id
        author
        tags
        isPurchasable
        sourceUrlWorks
      }
    }
  }
}
{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "name": "Pancakes",
            "id": "UmVjaXBlOjlhN2NjYTU3LWE5NDEtNDAwYS1iY2JjLTM5MGY5NmU3Y2QzYg==",
            "author": "Dr. Joel Kahn",
            "tags": [
              "VEGETARIAN",
              "GLUTEN_FREE",
              "Breakfast"
            ],
            "isPurchasable": false,
            "sourceUrlWorks": false
          }
        },
        {
          "node": {
            "name": "Pancakes",
            "id": "UmVjaXBlOjUwZDNlMDE2LWYyNmYtNDczOS1hODIxLTg5NTEzZGJjMjZjZQ==",
            "author": "Hadia's Lebanese Cuisine",
            "tags": [
              "VEGETARIAN",
              "GLUTEN_FREE",
              "Breakfast"
            ],
            "isPurchasable": false,
            "sourceUrlWorks": true
          }
        },
        {
          "node": {
            "name": "Pancakes",
            "id": "UmVjaXBlOjEwMjBmNGI5LTRmZGQtNGY4YS1iYjc1LTIyNDhhNzgzYWFkNA==",
            "author": "Food.com",
            "tags": [
              "VEGETARIAN",
              "GLUTEN_FREE",
              "Breakfast"
            ],
            "isPurchasable": false,
            "sourceUrlWorks": true
          }
        },
        {
          "node": {
            "name": "Golden Pancakes",
            "id": "UmVjaXBlOjM3OTNlZTdjLTcyOTMtNDA3Mi05Zjk0LTBmNmFmZWQyYjBlMA==",
            "author": "Food52",
            "tags": [
              "VEGETARIAN",
              "GLUTEN_FREE",
              "Breakfast"
            ],
            "isPurchasable": false,
            "sourceUrlWorks": true
          }
        },
        {
          "node": {
            "name": "Quinoa Pancakes",
            "id": "UmVjaXBlOjNiOWM1YjFkLWYzYTItNDYwMy04OWYzLWI5Yjc3OGJmNjgzMA==",
            "author": "Lively Table",
            "tags": [
              "VEGETARIAN",
              "DAIRY_FREE",
              "GLUTEN_FREE",
              "Breakfast"
            ],
            "isPurchasable": false,
            "sourceUrlWorks": true
          }
        }
      ]
    }
  }
}

Search by Macro Nutrients Ranges

{
  recipeSearch(
    query: "salad",
    macroNutrientsRange: {
    	calories: {gte:100, lte:300},
    	proteinCalories: {gte:100, lte:200},
  		fatCalories: {gte:50, lte:200},
  		carbsCalories: {gte:30, lte:150},
      protein: {gte:20, lte:200}
    }
    first:3) {
    edges {
      node {
        id
        name
        nutrientsPerServing {
          calories
          protein
          fat
          carbs
          omega3
        }
      }
    }
  }
}
{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "id": "UmVjaXBlOjNhOGQ5NTcwLTAxYzgtNDFhZS04YTMyLTIxZTYxYmIwMGRiMQ==",
            "name": "Turkey Taco Salad",
            "nutrientsPerServing": {
              "calories": 264.17,
              "protein": 26.86,
              "fat": 5.81,
              "carbs": 26.12,
              "omega3": 0.03
            }
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjM4YWY2YWY0LWQ5NTItNDhlYy1hNDQyLTRhODczNmYwYzc0Ng==",
            "name": "Chili Chicken Salad",
            "nutrientsPerServing": {
              "calories": 228.56,
              "protein": 26.34,
              "fat": 5.74,
              "carbs": 17.88,
              "omega3": 0.02
            }
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjA0MDU5Y2YyLTk1OTYtNDBhMy1hOWFkLWI3MzBlMzJlYjExYQ==",
            "name": "Blackened Shrimp Salad",
            "nutrientsPerServing": {
              "calories": 242.14,
              "protein": 32.15,
              "fat": 6.58,
              "carbs": 13.59,
              "omega3": 1.15
            }
          }
        }
      ]
    }
  }
}

Search by Ingredients

{
  recipeSearch(query: "milk", ingredients: ["banana"]) {
    edges {
      node {
        name
        ingredients {
          name
        }
      }
    }
  }
}
{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "name": "Monkey Milk",
            "ingredients": [
              {
                "name": "ripe banana"
              },
              {
                "name": "bananas"
              },
              {
                "name": "vanilla yogurt"
              },
              {
                "name": "milk"
              },
              {
                "name": "honey"
              },
              {
                "name": "ice cubes"
              }
            ]
          }
        }
      ]
    }
  }
}

Search by Cuisine

{
  recipeSearch(query: "Taco" cuisines: "Mexican") {
    edges {
      node {
        name
        cuisines
      }
    }
  }
}
{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "name": "Taco Stuffed Avocados Aka “Avo-Tacos”",
            "cuisines": [
              "Mexican"
            ]
          }
        },
        {
          "node": {
            "name": "Taco Stuffed Avocados Aka “Avo-Tacos”",
            "cuisines": [
              "Mexican"
            ]
          }
        },
        {
          "node": {
            "name": "Taco Salad",
            "cuisines": [
              "Mexican"
            ]
          }
        }
      ]
    }
  }
}

Search with multiple filters and no query string

 {
  recipeSearch(
    dietaryTag: GLUTEN_FREE
    mealTime: LUNCH
    hasInstructions: true
    macroNutrientsRange: {
      calories: { gte: 100, lte: 500 }
      proteinCalories: { gte: 100, lte: 500 }
      fatCalories: { gte: 50, lte: 500 }
      carbsCalories: { gte: 30, lte: 500 }
      protein: { gte: 20, lte: 200 }
    }
    first: 5
  ) {
    edges {
      node {
        id
        name
        author
        tags
        cuisines
        nutrientsPerServing {
          calories
          protein
          fat
          carbs
        }
      }
    }
  }
}
{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "id": "UmVjaXBlOmFiMmIzNTFmLTZmNWItNDEwOS1iODA3LTM1OGZhOTVkYjgyNQ==",
            "name": "Veggie Lasagna",
            "author": "Dr. Joel Kahn",
            "tags": [
              "VEGETARIAN",
              "GLUTEN_FREE",
              "Dinner",
              "PLANT_BASED",
              "DAIRY_FREE",
              "VEGAN"
            ],
            "cuisines": [],
            "nutrientsPerServing": {
              "calories": 455.24,
              "protein": 35.86,
              "fat": 8.59,
              "carbs": 58.62
            }
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmZmOTllZjY5LTY4MjEtNDU5Ny1iOGI1LWUxOTk3ODMzN2QxNA==",
            "name": "Smoked Mackerel Salad With Fennel And Apple",
            "author": "Suggestic",
            "tags": [
              "Salad",
              "GLUTEN_FREE",
              "DAIRY_FREE"
            ],
            "cuisines": [],
            "nutrientsPerServing": {
              "calories": 468.78,
              "protein": 37.02,
              "fat": 10.13,
              "carbs": 57.37
            }
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmVmNzBhNTY2LWY5NzctNGI2MS1iMzdiLTBjMzQ2NWZmYTFjOA==",
            "name": "Shallot Lime Marinated Flank Steak",
            "author": "J.J. Virgin",
            "tags": [
              "Dinner",
              "GLUTEN_FREE",
              "DAIRY_FREE"
            ],
            "cuisines": [],
            "nutrientsPerServing": {
              "calories": 323.06,
              "protein": 32.04,
              "fat": 17.4,
              "carbs": 9.58
            }
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmFjOGFkOGE5LTk4NTYtNGU2MS1hZTNkLTMyNmE0ZTMxNDZmZQ==",
            "name": "Taj’S Chicken Tenders",
            "author": "J.J. Virgin",
            "tags": [
              "Appetizer",
              "GLUTEN_FREE",
              "DAIRY_FREE"
            ],
            "cuisines": [],
            "nutrientsPerServing": {
              "calories": 309.92,
              "protein": 30.22,
              "fat": 7.52,
              "carbs": 30.33
            }
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmQ0ZTQ0NTNhLTQyODgtNDE5OS1hZjMwLTNlY2RkYTkyYWVhZg==",
            "name": "Tuna-Stuffed Tomato",
            "author": "Suggestic",
            "tags": [
              "Salad",
              "GLUTEN_FREE",
              "DAIRY_FREE"
            ],
            "cuisines": [],
            "nutrientsPerServing": {
              "calories": 484.66,
              "protein": 27.3,
              "fat": 32.99,
              "carbs": 19.64
            }
          }
        }
      ]
    }
  }
}

Search for more than one mealtime at the same time

The following example searches for Breakfast, Lunch, and Dinner recipes.

{
  recipeSearch(
    filter: {
      must: [{ mealTime: BREAKFAST }, { mealTime: LUNCH }, { mealTime: DINNER }]
    }
  ) {
    edges {
      node {
        id
        name
        ingredients {
          name
        }
      }
    }
  }
}
{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "id": "UmVjaXBlOjI2NDAwYzExLTEyNWQtNDc4Mi1iODNjLTZjNzQ5MjNhZTlhYg==",
            "name": "Turkey And Veggie Wrap",
            "ingredients": [
              {
                "name": "Yellow bell pepper"
              },
              {
                "name": "Baby spinach"
              },
              {
                "name": "Olive oil"
              },
              {
                "name": "Turkey breast"
              },
              {
                "name": "Brown rice tortilla"
              },
              {
                "name": "Rosemary"
              },
              {
                "name": "Onion"
              },
              {
                "name": "Lemon juice"
              }
            ]
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjYwYWM3NzA1LTBmNGEtNDVlMS04MGEwLWZlMTlmM2ExMWMzOA==",
            "name": "Spicy Black Bean And Quinoa Burritos",
            "ingredients": [
              {
                "name": "Cilantro"
              },
              {
                "name": "Corn"
              },
              {
                "name": "Salt"
              },
              {
                "name": "Orange bell pepper"
              },
              {
                "name": "Chili powder"
              },
              {
                "name": "Garlic"
              },
              {
                "name": "Water"
              },
              {
                "name": "Black beans"
              },
              {
                "name": "Roma tomatoes"
              },
              {
                "name": "Tortillas"
              },
              {
                "name": "Red onion"
              },
              {
                "name": "Cumin"
              },
              {
                "name": "Chipotle powder"
              },
              {
                "name": "Quinoa"
              }
            ]
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmE0NDY2NmViLWY1YjEtNDhiNS1hNDJhLWZmYTBlMjk4MTA1Yg==",
            "name": "Mint Frittata",
            "ingredients": [
              {
                "name": "Eggs"
              },
              {
                "name": "Parmesan cheese"
              },
              {
                "name": "Salt"
              },
              {
                "name": "Black pepper"
              },
              {
                "name": "Olive oil"
              },
              {
                "name": "Onion"
              },
              {
                "name": "Mint leaves"
              }
            ]
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmZiYTZkYTBiLWRkYTEtNGUyYS1hODQ2LWZmNWEwYTUzYzMzOA==",
            "name": "Guacamole-Manchego Quesadillas With Salad",
            "ingredients": [
              {
                "name": "Flour tortillas"
              },
              {
                "name": "Vinaigrette dressing"
              },
              {
                "name": "Guacamole"
              },
              {
                "name": "Salad"
              },
              {
                "name": "Manchego cheese"
              }
            ]
          }
        }
      ]
    }
  }
}

The following is a recursive example in which the recipes are searched by fish or spicy recipes and breakfast as a mealtime.

{
  recipeSearch(
    filter: {
      should: [
        { name: "fish" }
        { must: [{ name: "spicy" }, { mealTime: BREAKFAST }] }
      ]
    }
  ) {
    edges {
      node {
        id
        name
      }
    }
  }
}

{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "id": "UmVjaXBlOmJlZWNhMjEwLTFlOWQtNDgyNy1hZDZjLTljMmUyOTI1ZDgwYg==",
            "name": "Easy Pita Lunch Ideas"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjhiNmNkYmNkLTk3MzAtNDQ2Ni1iNGJiLWNlNzZhMTMxZGFmYQ==",
            "name": "Chile-Cumin Lamb Meatballs With Yogurt And Cucumber"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmQyNGVmNjBjLWU5ZjktNDM1Ny1hZjU5LWZmZWZhMGVjMzFkZA==",
            "name": "Vegan Stacked Enchilada Pie"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjFhMDgzZWVmLWNjZTctNDNlOC05MjgzLTFkYzQwY2QzYWU5Yw==",
            "name": "Mung Bean + Cilantro Falafel Tacos (V + Gf)"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjhkNWEwYTgwLTdiZGMtNDY5ZC1iYWMxLTJlNTBlOTA2YTBlOA==",
            "name": "French Tuna Burger With Green Bean Salad"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjA3Zjg4OWMyLWI4Y2YtNDE2ZC04MDM1LTA1MDhkMTkyMjFhMg==",
            "name": "Farmers Market Minestrone Soup {Share The Love}"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjFjYjlhNTU0LTRjMGYtNDNiNi1hYWViLWYwNzcxNGJmNWU4Mg==",
            "name": "Vegan Cauliflower, Potato, And Chickpea Curry"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmY4OTZiNTY5LWFlNmEtNGFhMy04NDgzLTZlMDVjODM4YTc4NQ==",
            "name": "Yogurt-Marinated Chicken Shawarma"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmZmMTg3YmYwLTIxMmItNDUzZS04MTkyLWI2YTFlYThiNzE0OA==",
            "name": "Pan Bagnat - A Nicoise-Style Sandwich"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmNmODY2ZWI2LTJmYjktNDUxNS1hOTBhLWYxN2Q5OTNlNzBjNQ==",
            "name": "Mediterranean Chopped Salad"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjYwYTU0MzNiLTVjN2MtNDBmOS05NjgwLTk1ZTUyNGQzN2ZlYg==",
            "name": "Thai Panang Curry"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjRkMThiMTBjLTUyZGItNDg2YS05MDc2LTFjZjM3NzZhZDI0OQ==",
            "name": "Peanut Thai Vegetable Stew"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjBkZjIyNjQxLWQ4ZTktNDQxMS1hNGJhLTFiN2UzZWYyMGNjZg==",
            "name": "Slow-Cooker Cuban Brisket Taco Bowls"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjFmOWVmZWY1LTZjYzEtNGE1Ny1hOWZmLWZjMjEzZjAxNTgxOQ==",
            "name": "Easy Peanut Pork With Crunchy Veg"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjk1YmI2YzQwLTQzOGUtNDUwOS04OTc4LTk5OGRmY2ZlNzFhNQ==",
            "name": "Red Lentil Sweet Potato Hemp Burgers With Ginger Basil Sauce"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjRkMGI2YjFhLTk4NGItNGRkZS05NTc3LThmMGM3N2QyMzdjNQ==",
            "name": "Leftover Salade Nicoise"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmY2MmUxNDlhLWFkMmMtNGZhNC1iZDM4LTczYTc4ZTVlMjc1ZQ==",
            "name": "Spicy Peanut Noodles With Edamame & Shrimp"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjI1YzZhOGU4LTk1YjAtNGI1NS1hNjhjLWVmODA1MWU4ZjczZA==",
            "name": "Southwest Pinto Bean Burgers With Chipotle Mayonnaise"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjQ2MzVmNmJlLTgwODEtNDczOS05ZmJjLWQxZjQ0MGQyNDgxZQ==",
            "name": "Apple-Brat Burgers"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmIzM2IwYjM4LWMyZmUtNGUzZS1iY2UyLTg1OTU5NjMwMzZmYQ==",
            "name": "Sri Lankan Black Chicken Curry With Roasted Spices"
          }
        }
      ]
    }
  }
}

Search for multiple ingredients and two mealtimes

The following example searches breakfast AND snack AND which contains milk and bread as a single ingredient OR yogurt

{
  recipeSearch(
    filter: {
      must: [{ mealTime: BREAKFAST }, { mealTime: SNACK }]
      should: [{ ingredients: "milk, bread" }, { ingredients: "yogurt" }]
    }
  ) {
    edges {
      node {
        id
        name
      }
    }
  }
}
{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "id": "UmVjaXBlOjEzNGE1MGYzLWJjMGEtNGVmNS1hNjlkLWQ4MTNiNzFlZWEyMA==",
            "name": "Protein Power Lentils And Amaranth Patties"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjQ3NzlmYmJmLTM1MjktNDhiMi1iOGU4LTgyMWNiNjQ2MmQwYw==",
            "name": "Banana And Mixed Berry Smoothie "
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmViOTcyZWI0LTA3OGMtNDFlNC1iMDlkLWU1YTljMTA3MzZmOQ==",
            "name": "Back To School Granola Bars"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjZjYWNlNTJlLTEzMWEtNDM0MS05Zjk5LWI2MDUzZTY3ZTNjOA==",
            "name": "Sugar-Free Healthy Granola Bars"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmM0YmQzMDIzLWZmNWMtNGYwOC05MTdkLTJhYjcyYTNlNjU4Yw==",
            "name": "Apple & Banana Quinoa Oat Bites"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmNiZDFjOTZkLTYyNWMtNDExNi1iNzhkLTFkMjhiMjdmMGVjOQ==",
            "name": "Vegan Coconut Milk Raspberry Smoothie"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmM2NjkyNjUyLWMwOGQtNDMxOC04ZmQzLWVkMTc5YjYzYTQzMQ==",
            "name": "Green Smoothie"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjVjZDkwMDkzLTYyZDItNGUyOS1iNjZkLWU3OTk1MjRiZjRlMQ==",
            "name": "No Sugar Added Granola Bars"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjQ4MWM2MDFkLWNmYjMtNDgyYy04YzhjLTEwMzhlZmRjZDYyMQ==",
            "name": "Coconut Yogurt With Blackberries And Almonds"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmMzZGE3OWY2LTJhZTctNGRjNS05MDJkLWJjMDMwMDRlZjQyMg==",
            "name": "Apple Cinnamon Granola Bites"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjgzZDc0NzYwLTM0MzctNDZhNy1iNjdlLTM1ZTZiZjBiZmNmZA==",
            "name": "Greek Yogurt With Nuts And Berries"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmQ3MTMxOGZjLTRjMjQtNGExMS05YTFkLTRjYTgwYjViMTRiMw==",
            "name": "Coconut Yogurt With Blackberries And Almonds"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjE0MDEzNDJjLTkyMDctNDFjNC1hM2JlLWY5NDIyYWIxNDczYg==",
            "name": "Peanut And Sesame Brittles Or Mungfali And Til Ke Chikki"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmJkOTFlMjVjLTIyNzEtNDQzMS05ZWUxLTg2ZDg2ODNjYzY0ZQ==",
            "name": "Scrambled Egg Toasts With Avocado"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjYyNDZmNjVmLTc4NTMtNDQyMy04ODI5LWYxZjI1YWVkYmUyYQ==",
            "name": "Delicious Poached Eggs, Spinach And Avocado Toast"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmZkNDU3MzFkLWRjOGQtNDkzMS1iNGQ5LTA1ZWExZmIyNjhlMw==",
            "name": "Cinnamon 'N' Spice Pecans"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmNjNTEzZTczLTE0MTktNGYwZC1iMWY4LWM5MzVhZDA3YjU2ZA==",
            "name": "Sina'S Georgia-Style Boiled Peanuts"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOjE1YTA2MWQzLTc2MTMtNGZkNC05YjA0LWYyMzRiMTNlYTUwOA==",
            "name": "Oat-Date Bars"
          }
        },
        {
          "node": {
            "id": "UmVjaXBlOmY0YmFmNTU2LWQyY2UtNDA1Ni1hNzdjLWEwMGEyMjFlM2VhNg==",
            "name": "Soft Boiled Eggs With Grilled Cheese Soldiers"
          }
        }
      ]
    }
  }
}

Filter by number of servings

{
  recipeSearch(servingQuantity: 6) {
    edges {
      node {
        name
        numberOfServings
      }
    }
  }
}

Filter by ingredient restriction

This example searches for a “salad” recipe where all results must include the ingredient “tomato” and exclude the ingredient “egg.”

query {
  recipeSearch(
    query:"salad" 
    filter:{
      must:{
        ingredients:"tomato"
      }
    	mustNot:{
        ingredients:"egg"
        tags:"high-fat"
      }
    }
  ){
    edges{
      node{
        name
        ingredients{
          name
        }
        ingredientLines
      }
    }
  }
}

{
  "data": {
    "recipeSearch": {
      "edges": [
        {
          "node": {
            "name": "Rocket Salad",
            "ingredients": [
              {
                "name": "Rocket leaves"
              },
              {
                "name": "Tomato"
              },
              {
                "name": "Corn"
              },
              {
                "name": "Cucumber"
              },
              {
                "name": "Tomatoes"
              },
              {
                "name": "Olive oil"
              },
              {
                "name": "Balsamic vinegar"
              },
              {
                "name": "Salt"
              },
              {
                "name": "Peppercorns"
              }
            ],
            "ingredientLines": [
              "2 cup rocket leaves",
              "1 tomato, diced",
              "1/4 cup corn",
              "1 cucumber, dced",
              "2 tbsp diced sun dried tomatoes",
              "1 tbsp olive oil",
              "1 tbsp balsamic vinegar",
              "Salt, to taste",
              "Pepper, to taste"
            ]
          }
        },
        {
          "node": {
            "name": "Shopska Salad",
            "ingredients": [
              {
                "name": "Tomato"
              },
              {
                "name": "Cucumber"
              },
              {
                "name": "Red bell pepper"
              },
              {
                "name": "Olives"
              },
              {
                "name": "Olive oil"
              },
              {
                "name": "Balsamic vinegar"
              },
              {
                "name": "Salt"
              },
              {
                "name": "Black pepper"
              },
              {
                "name": "Feta cheese"
              },
              {
                "name": "Parsley"
              },
              {
                "name": "Whole grain bread"
              }
            ],
            "ingredientLines": [
              "1 large tomato, diced",
              "1 cucumber, diced",
              "1 red bell pepper, diced",
              "1 handful pitted olives (optional)",
              "Extra virgin olive oil, to taste",
              "1 oz balsamic vinegar",
              "Salt, to taste",
              "Freshly cracked black pepper, to taste",
              "4 oz feta cheese",
              "1 oz flat leaf parsley, chopped",
              "2 oz whole-grain bread"
            ]
          }
        },
        {
          "node": {
            "name": "Caprese Salad",
            "ingredients": [
              {
                "name": "Tomato"
              },
              {
                "name": "Mozzarella cheese"
              },
              {
                "name": "Basil leaves"
              },
              {
                "name": "Olive oil"
              },
              {
                "name": "Balsamic vinegar"
              },
              {
                "name": "Salt"
              },
              {
                "name": "Black pepper"
              }
            ],
            "ingredientLines": [
              "1 tomato, sliced",
              "4 oz mozzarella cheese",
              "1/4 cup basil leaves",
              "1 tbsp olive oil",
              "1 tsp balsamic vinegar",
              "Salt, to taste",
              "Ground black pepper, to taste"
            ]
          }
        }
      ]
    }
  }
}

[]

List of cuisines. Check to see all the available cuisines.

DietaryTag
String
this list
Ingredients
MacroNutrientsRangeInput
Food Filter
filter
adherence
searchRecipeByNameOrIngredient.
macroNutrientsRange
dietaryTag
ingredients
cuisines
mealTime
hasinstructions
cuisine