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
      • April
  • 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 Arguments
  • Available Fields
  • Example

Was this helpful?

  1. Suggestic API Reference
  2. Queries
  3. Recipes

Recipes By Tag

Obtain recommended recipes by mealTag

PreviousRecipes By MealTimeNextRecipe Swap Options

Last updated 3 years ago

Was this helpful?

Use the recipesByTag query to obtain recommended recipes for different meals tag.

Options: 'Appetizer', 'Sauce', 'PLANT_BASED', 'Branded', 'Salad', 'Tea', 'Fried', 'GLUTEN_FREE', 'Cocktail', 'Shake', 'Dip', 'Side', 'Snack', 'Lunch', 'Dessert', 'VEGETARIAN', 'Vegetarian', 'Soup', 'Gluten-Free', 'Kids', 'Wine', 'Beverage', 'Dinner', 'Breakfast', 'DAIRY_FREE', 'Bread', 'VEGAN'

Refer to to find a complete tag list.

This query is a variant of .

Available Arguments

Argument Name

Type

Description

dietaryTags

[DietaryTag]

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

maxPrepTime

Int

Maximum preparation time in minutes.

Filters out recipes with prep time longer than the value.

Tag

String

Available Fields

The following fields will be displayed in the response:

Field Name

Type

Description

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

name

String

Name of the recipe

Example

{
  recipesByTag(tag: "Breakfast" dietaryTags:[DAIRY_FREE] maxPrepTime:8) {
    edges {
      node {
        name
        mealTags
        programIds
        author
        servingWeight
        numberOfServings
        instructions
        ingredientLines
        
      }
    }
  }
}
{
  "data": {
    "recipesByTag": {
      "edges": [
        {
          "node": {
            "name": "Breakfast Oats With Fruit And Coconut Milk Yogurt",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": [
              "46477417-dc4e-425c-b3a9-f2bc9b129102",
              "b30cf02a-7215-4c25-96be-6b047c25338e",
              "8e8b8c1c-b548-4602-81e5-776e9672b5cd"
            ],
            "author": "Suggestic",
            "servingWeight": 759.1666666666666,
            "numberOfServings": 1,
            "instructions": [
              "Add all ingredients to a bowl and serve.",
              "You can cook the oats in water beforehand, if you prefer.",
              "You can also blend all ingredients in a blender and create a smoothie, adding extra water to adjust the consistency."
            ],
            "ingredientLines": [
              "1/2 cup almonds",
              "1 cup unsweetened coconut milk yogurt",
              "1/2 cup steel cut oats",
              "1 cup blueberries",
              "1 banana"
            ]
          }
        },
        {
          "node": {
            "name": "Pumpkin Apple Smoothie Bowl",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "My Modern Cookery",
            "servingWeight": 539.6583333333333,
            "numberOfServings": 2,
            "instructions": [],
            "ingredientLines": [
              "2 tbsp hemp seeds",
              "2 tbsp pumpkin seeds - I forgot to use mine",
              "1 cup chopped apple (you can leave the peel on)",
              "¼ cup chopped apple",
              "⅔ cup pumpkin puree",
              "¼ cup coconut flakes",
              "1 tsp ground cinnamon",
              "¼ tsp ground ginger",
              "1 frozen banana",
              "⅔ cup rolled oats",
              "½ cup almond milk",
              "2 tbsp chia seeds",
              "½ tsp turmeric",
              "½ tsp vanilla"
            ]
          }
        },
        {
          "node": {
            "name": "Whole30 Apple-Coconut Breakfast Bowl",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "Prevention RD",
            "servingWeight": 347.35,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "2 Tbsp unsweetened coconut",
              "2 medjool dates, pitted and roughly chopped",
              "2 Tbsp pecans",
              "1 medium apple, cored and cut into large chunks",
              "1 Tbsp almond butter + 1 Tbsp water"
            ]
          }
        },
        {
          "node": {
            "name": "Dairy-Free Coffee Creamer",
            "mealTags": null,
            "programIds": null,
            "author": "Running with Spoons",
            "servingWeight": 217.25,
            "numberOfServings": 2,
            "instructions": [],
            "ingredientLines": [
              "1½ cups light canned coconut milk*",
              "½ cup hot water",
              "½ cup of dates, pitted",
              "½ Tbsp. vanilla extract"
            ]
          }
        },
        {
          "node": {
            "name": "Paleo Green Pumpkin Pie Smoothie",
            "mealTags": null,
            "programIds": null,
            "author": "Tessa the Domistic Diva",
            "servingWeight": 479.63285645833326,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "Optional protein boosters: ¼ cup cottage cheese or greek yogurt, 2 tablespoons raw cashews.",
              "2 medjool dates (very soft, or soaked in water to soften)",
              "1 teaspoon cinnamon",
              "¼ cup FULL FAT canned coconut milk (or any full fat milk of choice)",
              "⅛ teaspoon sea salt",
              "Handful ice cubes",
              "2 handfuls spinach",
              "1 cup water",
              "⅔ cup FRESH pumpkin puree (use less to start if you used the canned variety...it is not nearly as sweet and can overpower the flavor of the smoothie)",
              "3 tablespoons cold soluable gelatin, I like Great Lakes green can, or Vital Proteins blue can",
              "Steviaor honey to taste",
              "¼ teaspoon ginger"
            ]
          }
        },
        {
          "node": {
            "name": "Fruit-Free Green Smoothie",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "In Sonnet's Kitchen",
            "servingWeight": 458.8,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "6 ice cubes",
              "1 cup coconut water",
              "½ lemon, peeled",
              "¼ cup parsley",
              "½ organic cucumber, chopped",
              "½ avocado, pitted and peeled",
              "2 cups organic, raw spinach"
            ]
          }
        },
        {
          "node": {
            "name": "5 Minute Banana Chocolate Chip Quinoa Flake Bake",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "Healthful Pursuit",
            "servingWeight": 189.99687489465478,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "1 tablespoon dairy-free chocolate chips or carob chips",
              "¼ cup egg white – see note",
              "1 tablespoon pecans, chopped",
              "3 tablespoon banana, mashed",
              "½ cup quinoa flakes",
              "Pinch cinnamon and nutmeg"
            ]
          }
        },
        {
          "node": {
            "name": "Creamy Apple Cinnamon Smoothie",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "She Well",
            "servingWeight": 531.05,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "1 cup unsweetened almond milk",
              "1/2 ripe banana, frozen",
              "1/4 teaspoon cinnamon",
              "3 ice cubes",
              "1 tablespoon almond butter",
              "2 tablespoons old fashioned oats",
              "1/2 medium apple, chopped"
            ]
          }
        },
        {
          "node": {
            "name": "Cinnamon Tropical Smoothie",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "Strictly Delicious",
            "servingWeight": 645.475,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "1/2 teaspoon ground cinnamon",
              "1/2 cup frozen mango",
              "1 c. coconut milk",
              "1/2 cup frozen pineapple",
              "1 tablespoon chia seeds, optional (omit for AIP)",
              "1 ripe large banana, peeled"
            ]
          }
        },
        {
          "node": {
            "name": "Healthy And Paleo Apple Banana Smoothie",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "Oh Snap! Let's eat!",
            "servingWeight": 195.25,
            "numberOfServings": 4,
            "instructions": [],
            "ingredientLines": [
              "1 Banana",
              "1 cup of Coconut Milk",
              "Ice (optional)",
              "1 Apple"
            ]
          }
        },
        {
          "node": {
            "name": "Flax Seed Smoothie",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "AllRecipes",
            "servingWeight": 521.5,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "1 cup low-fat vanilla soy milk",
              "1/2 frozen banana, peeled and cut into chunks",
              "1 cup frozen strawberries",
              "2 tablespoons flax seed meal"
            ]
          }
        },
        {
          "node": {
            "name": "Creamy Avocado & Egg Breakfast",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "Slow Cooker Central",
            "servingWeight": 126.15,
            "numberOfServings": 2,
            "instructions": [],
            "ingredientLines": [
              "1 large avocado",
              "2 eggs",
              "Cracked black pepper"
            ]
          }
        },
        {
          "node": {
            "name": "Pumpkin Spice Smoothie",
            "mealTags": null,
            "programIds": null,
            "author": "Jesse Lane Wellness",
            "servingWeight": 654.1441774740815,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "½ tsp cinnamon",
              "1 Tbsp flax seeds",
              "¾ cup pumpkin puree",
              "¼ inch fresh ginger, peeled",
              "Pinch ground cloves",
              "1 scoop French Vanilla Purely Inspired 100% Plant-Based Protein Nutritional Shakes",
              "Pinch ground nutmeg",
              "1.5 cups nut milk"
            ]
          }
        },
        {
          "node": {
            "name": "Blueberry Banana Smoothie",
            "mealTags": [],
            "programIds": null,
            "author": "Cook AZ I Do",
            "servingWeight": 112.83738078125,
            "numberOfServings": 4,
            "instructions": [],
            "ingredientLines": [
              "1/2 c orange juice",
              "1 banana, frozen",
              "1/2 c frozen blueberries",
              "1 handful spinach, approximately 1 cup"
            ]
          }
        },
        {
          "node": {
            "name": "Creamy Cinnamon Banana Smoothie",
            "mealTags": [],
            "programIds": null,
            "author": "Life's Ambrosia",
            "servingWeight": 319.60176527666664,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "1/2 avocado",
              "3/4 teaspoon ground cinnamon",
              "1/2 teaspoon vanilla",
              "1 cup Silk Original Cashew Milk",
              "1/2 cup loosely packed baby spinach leaves",
              "1/2 cup ice cubes"
            ]
          }
        },
        {
          "node": {
            "name": "Blueberry, Banana And Kale Smoothie",
            "mealTags": [
              "Breakfast"
            ],
            "programIds": null,
            "author": "Yolo Sole",
            "servingWeight": 535.35,
            "numberOfServings": 1,
            "instructions": [],
            "ingredientLines": [
              "1½ cups raw kale",
              "2 tbsp almonds",
              "½ orange",
              "½ cup ice cubes",
              "1 banana",
              "1 tbsp flax seeds",
              "¼ cup blueberries"
            ]
          }
        }
      ]
    }
  }
}

List of

Refer to to get the complete list of recipe fields you can add to the query response

this document
recipesByMealTime
this documentation
tags