Recipe Data Requirements Documentation

The following describes the required recipe data and formatting for proper ingestion into the Grocery Shopii system.  To ensure the integrity of our platform and the shopper’s experience, we require data in a certain format.  Please use this guide to ensure your recipe content is ready to be uploaded into the Grocery Shopii system. 

Recipe Taxonomy 

Grocery Shopii groups recipe data according to the following categories to provide data consistency and legibility across multiple systems. 

  • Title/Description 

    • Title is the name of the recipe 

    • Description is at most a three-line description of the recipe 

  • Meal Category 

    • Breakfast, Brunch, Lunch, Dinner, etc… 

  • Cuisine Category 

    • Italian, Mexican, Indian, etc… 

  • Dietary Category 

    • Paleo, Vegan, Vegetarian, etc… 

  • Health Labels 

    • Dairy-Free, Peanut-Free, Shellfish-Free, etc… 

  • Equipment 

    • Grille, Crock Pot, InstaPot, etc… 

  • Time 

    • Prep Time in minutes 

    • Cook Time in minutes 

  • Serving Size 

    • 4, 6, 8, 10, or Family 

  • Ingredients 

    • One ingredient per line 

    • Each will need to have the following attributes 

      • Quantity (1, ½, etc) 

      • Measurement (oz, tbsp, etc…) 

      • Name (grated Parmesan cheese) 

      • Note (to taste, minced) 

      • GTIN (Global Trade Item Number) if available 

  • Steps 

    • All recipe prep or cooking steps will be in a numbered list with one step per line 

    • Sections for recipe components can be defined, such as for a salad dressing 

  • Images 

    • At least one image is required per recipe.  This image will be the primary image for the recipe. 

    • All images should have the following attributes 

    • 1500-2500 pixels wide 

    • 250-750 KB in size 

    • JPG or PNG formats 

Recipe Formats

Grocery Shopii currently accepts recipe data in either JSON or XML formats.  All recipes must be in the same format per source.  All recipe data should be cleansed before exporting into respective format to insure clean upload and quality results. 

Please refer to the links below for examples:

JSON        XML

If you have further questions, please contact your Account Representative.

©2020 Grocery Shopii. All Rights Reserved.

  • LinkedIn - White Circle