Nutritionix releases 2.0 API Beta

by mattsilv on December 16, 2014  |  Topics: API

Summary

We are pleased to announce the launch of the Nutritionix 2.0 API Beta.  The beta period will last through February 2015.  We encourage you to submit feedback about the beta to [email protected].

Top 5 New Features in API 2.0

1.  Autocomplete

Nutritionix 2014-12-11 13-26-34

Our new autocomplete endpoint returns a clean list of commonly searched foods.  You can try a demo of autocomplete on the main search bar at nutritionix.com or in our iOS app.  Read the API 2.0 Autocomplete documentation.

2.  “Natural” endpoint

We now support natural language processing!   Send a query like “1 cup orange juice” or “100 cal yogurt” and our API returns the full array USDA nutrients for your requested measurement.  This opens the doors to a wide array of smart nutrition apps, including voice recognition and more.  Read the API 2.0 Natural Endpoint documentation.

3.  Recipe Building

natural-demo

Using our natural endpoint, you can send up to 20 ingredients at a time to get a sum of all of the nutrients for a particular recipe.  See our documentation on how to build recipes.

4. Exact Match

exact-match

Instead of only displaying search results for a user’s food query, our NutritionLink(tm) algorithm now estimates the exact portion size a user may be looking for.  This can drastically improve the user experience when adding foods to a food journal.  Check out the documentation in our API 2.0 Search Endpoint.

5.  Common International Dishes Curated by Registered Dietitians

Our in-house registered dietitian team has been hard at work building recipes for over 1,000 common food dishes from around the world.  Better yet, each dish is built with USDA SR27 nutrient data, which means every common dish has over 40 micronutrients available.  Want to know how much phosphorus is in 1 cup of shepherd’s pie?  No problem!

Ready to get started?  Head on over to the v2.0 beta documentation.

About Nutritionix

The Nutritionix API is already used by thousands of developers across the world in diet, fitness, and healthcare apps.  Here are some exciting stats about our API:

  • Nutritionix database includes over 400,000 unique foods with nutrition facts
  • 260K+ grocery barcodes linked to nutrition info
  • 220K+ ingredient statements linked to barcodes
  • Adding over 3K new grocery foods to the API every month
  • Serving over 3 Million API requests every month

Menu Labeling for Restaurants: The Complete Summary

by Danielle Colley, MS, RD on November 26, 2014  |  Topics: Restaurants

The FDA released a 395 page document listing all of the regulations for menu labeling.  The Nutritionix Expert Nutrition Policy Team has spent the last 36 hours studying the document to create the most extensive summary of the regulations.

If you have specific questions on how the regulations will affect your concept, please submit your question in the form below and one of our Nutrition Policy Experts will reach out with a personalized response.

Date to Comply and Enforcement

  • Must comply by December 1st, 2015
  • Enforcement rules have not yet been established however the FDA ensures that they will be set prior to the date of compliance.

Who Must Comply?

  • Restaurants and Similar Retail Food Establishments that are part of a chain with 20 or more locations, doing business under the same name, and offering substantially the same menu items
    • Those not covered under this description can register with the FDA every other year to become subject to these regulations
  • Bakeries
  • Cafeterias
  • Coffee Shops
  • Convenience Stores
  • Delicatessens
  • Food Service Facilities within Entertainment Venues, such as:
    • Amusement Parks
    • Bowling Alleys
    • Movie Theaters
  • Food Service Vendors, such as
    • Ice Cream Shops
    • Mall Cookie Counters
  • Food Take-Out & Delivery
  • Grocery Stores
  • Retail Confectionery Stores
  • Superstores
  • Quick Service Restaurants
  • Full Service Restaurants

Defining Menu/Menu Board

  • Menu or Menu Board: “Primary writing of the restaurant or similar retail food establishment from which a customer makes an order selection, including, but not limited to, breakfast, lunch and dinner menus, dessert menus, beverage menus, children’s menu’s, other specialty menus, electronic menus and menus on the Internet.“
  • Menu mailed as a flyer to a customer’s home could be considered “primary writing” from which the customer will make an order selection

How to Format the Calories

  • Calories must be listed adjacent to the name/price of the associated standard menu item
  • Rounding
    • Calories declared to the nearest 5-calorie increment up to 50, and 10-calorie increment above 50
    • Amount <5 calories can be expressed at 0
  • Word choice
    • The word “Calories” or “Cal” must appear at the top of a column or next to each calorie amount
  • Color/font
    • When displaying “Calories” or “Cal” above calories in a column
      • Font can be no smaller than the name of the item or price, whichever is smaller
      • The color and the font must be the same or at least as conspicuous as the standard menu item name and have the same contrasting background
    • When displaying “Calories” or “Cal” next to each calorie amount
      • Font must be the same size as the number of calories
      • The color must be the same and have the same contrasting background as the number of calories

Required Statements

  • All menus and menu boards must include the Succinct Calorie Intake Statement & Availability Statement
  • Succinct Calorie Intake Statement: “2,000 calories a day is used for general nutrition advice, but calorie needs vary”
    • To appear at the bottom of each menu page immediately above availability statement
    • In font no smaller than smallest calorie declaration and in a color as conspicuous as the calorie declaration
  • Availability Statement: “Additional nutrition information available upon request.”
    • To appear at bottom of first page with menu items and on every menu page
    • In font no smaller than smallest calorie declaration and in a color as conspicuous as the calorie declaration

Complete Nutrition Available On-Site

  • Must be available in written form on the premises of the restaurant to provide to customer upon request
  • Flexibility to use different types of media – flyers, posters, booklets, kiosks, computer
    • An example of how to display information on-site:

Required Written Nutrients

  • Complete written nutrition information must be available on the premises of each location and provided to customers upon request
  • Nutrient required includes:
    • Total Calories
    • Fat Calories
    • Total Fat
    • Saturated Fat
    • Trans Fat
    • Cholesterol
    • Sodium
    • Total Carbohydrate
    • Dietary Fiber
    • Sugars
    • Protein
  • Vitamins and minerals are optional
  • When changes to recipes are made, nutrition information must be updated prior to launch onsite
  • Information must be provided for each variable menu item (see definition below) separately

Where To Get Nutrition Information

  • Nutrient Databases
  • Laboratory Analytical Testing
  • Cookbooks
  • Be able to provide FDA with substantiating nutrient values upon request
  • Must have employee sign document verifying that all nutrition information is correct

Variable Items, Combos & Toppings

  • Variable Menu Item definition – “A standard menu item that comes in different flavors, varieties, or combinations, and is listed as a single menu item.”
  • Flavors
    • Calories must be listed separately for items that come in different flavors (e.g., different flavors of ice cream, soft drinks, donuts, dips, chicken grilled or fried)
    • If all flavors are not listed on menu such as “soft drinks” the calories must be listed with a slash if 2 flavors (e.g., “200/250″) or a range if more than 2 flavors (e.g., “100-350″)
    • If the variety is only for a particular part of a menu item (for example: sandwich with a choice between multiple cheeses) calories can be displayed with a slash for 2 options and range for more than 2 options
  • Combos
    • Do not have to declare calories separately when mixing and matching standard menu items for a special price (e.g., pick 2) if standard menu items are already on menu
    • If only 2 options are available for an item (e.g., sandwich with fries or with fruit) provide calories for both options with forward slash between
    • If combination meal offers increased/decreased sizes, must declare meal options’ calories with a slash for two options and range for more
  • Toppings
    • If toppings can be added to a menu item, the calories for the basic preparation of the menu item as well as the calories for each topping must be declared separately
    • When the portion size of a topping decreases as more toppings are added, calories for the topping may be represented as the calories for the topping amount used in the single topping menu item with a specification that the calorie declaration is for a single topping menu item
  • Sizes
    • For items with different sizes, calories for basic preparation of each size and toppings calories for each size must be displayed

Foods on Display & Self-Service

  • Food on Display definition: “restaurant or restaurant-type food that is visible to the customer before the customer makes a selection, so long as there is not an ordinary expectation of further preparation by the consumer before consumption.”
  • Self-Service Food definition: available at a salad bar, buffet line, cafeteria line or where the customer serves themselves
  • Calories can be posted to these foods by being accompanied with signs in the following ways:
    • An individual sign adjacent to the food that provides calories per serving
    • A sign attached to a sneeze guard above each specific menu item
      • The sign must be clearly associated with the corresponding food item
    • A single sign or place card that lists the name and calorie declaration for multiple items
      • Customer must be able to view this posting as they are making menu selections
  • For self-service soft drinks, the declaration of calories must be based on full volume of the cup (without ice) and description of cup size
  • A packaged food on display that already has a Nutrition Facts label is sufficient

Alcohol

  • Alcoholic beverages that are standard menu items (e.g., listed on the menu) are required to have calories on the menu and complete written nutrition information materials
  • Alcoholic beverages that are ordered by customers at the bar but are not listed on the menu are exempt
  • The USDA nutrition database is an acceptable source for obtaining information on nutrition content of alcohol
  • Alcohol used to make mixed drinks or alcohol that is on display behind a bar is exempt (e.g., bottles of spirits used to make alcoholic beverage menu items that are not menu items individually)

Pizza

  • Variable menu item (see above definition)
  • Custom order definition: a food order that is prepared in a specific manner based on an individual consumer’s request, which requires the covered establishment to deviate from its usual preparation of a menu item. Calorie declaration is not necessary for these items.
    • Example: “Meat Lover’s” pizza containing ground meat and sausage as a standard menu item, and a customer orders a “Meat Lover’s” pizza without sausage, would make that order a custom order.
  • Toppings
    • Calories must be separately declared for each topping listed on the menu or menu board
    • The menu or menu board must specify that the calories are added to the calories contained in the basic preparation of the menu item
    • Can use a range for each topping to represent the added calories across various sizes of the menu item
    • Can group toppings that have the same calorie amounts
      • after rounding as described under the formatting section
      • Must specify that the calorie declaration represents the calorie amount for each individual topping
    • If the general term, “toppings” is used on a menu or menu board, but the individual toppings are not listed
      • Calories must be declared for each option with a slash between the two calorie declarations where only two options are available (e.g., “150/250 calories”) or as a range where more than two options are available (e.g., “100-250 calories”).
  • Topping quantities vary by size
    • Specify calories for:
      • Basic preparation of the menu item for each size
      • Calories for each topping listed on the menu or menu board. Calories must either be:
        • declared separately for each size of the menu item
        • declared using a slash between the two calorie declarations for each topping where only two sizes of the menu item are available (e.g., “adds 150/250 cal”) or as a range for each topping where more than two sizes of the menu item are available (e.g., “adds 100-250 cal”)

Foods Not Covered by Regulations

  • Condiments
  • Seasonal or temporary menu items that are on the menu for <60 days
  • Daily specials
  • Food sold on vehicles such as food trucks, planes, and trains

 

Fill out my online form.

 

Danielle Colley, MS, RD
Danielle Colley, MS, RD
Director, Nutrition
[email protected]

 


About Nutritionix:

Nutritionix is the world’s leading provider of interactive nutrition tools for restaurant chains.  Our web-based management platform allows restaurants to instantly publish nutrition data to the web, mobile web, and digital menu boards. Nutritionix offers menu labeling consulting services to ensure your brand stays compliant.  For more information, contact us via email at [email protected]

FDA Menu Labeling Summary for Restaurant Chains

by Danielle Colley, MS, RD on November 25, 2014  |  Topics: Announcements, Restaurants

The new FDA restaurant menu labeling requirements have arrived. For your convenience, we are summarizing the 395 page FDA docket below and providing you with step-by-step instructions on how to comply!

(NOTE: for the complete updated summary

please visit our new FDA regulations summary post)

Who must comply?

All restaurants and similar retail food establishments with 20 or more locations.  [See Complete List]

When does this go into effect?

Although you are not required to comply until December 1st, 2015, you should start the process immediately. On average, it takes several months to compile all of the information necessary and to create new signage.

What do I need to do?

  • Post calories for all standard menu items
  • Provide full nutritional breakdowns upon customer request
  • Include succinct statements on menus to provide reference for customers

Where do calories and nutrition details need to be posted?

  • Calories must be posted on all menus and menu boards next to the item name or price
  • Complete nutrition must be available upon customer request at all locations
  • See: Additional Placement Details

How do I get help complying with these new rules?

Nutritionix provides menu labeling consulting to over 60 national restaurant chains.  To get a free consultation, please fill out the form below, or contact us at [email protected].

Are you a restaurant operator?  See below to learn more about compliance.

UPDATE 11:01AM EST Our available time slots have now filled up for this week.  Please use the form below to be added to our consultation wait list.  If you have an urgent inquiry, please email us at [email protected].


Fill out my online form.

UPDATE 2:23PM EST Below is an update to the list of regulations.

How do restaurants comply?

  • Post calories for all standard menu items
  • Declare total calories for meal-combos
    • i.e. a meal with a sandwich, side, and beverage
  • Provide full nutritional breakdowns upon customer request
    • The full breakdown must include the following fields:
      • Total calories, calories from fat, total fat, saturated fat, trans fat, cholesterol, sodium, total carbohydrates, fiber, sugars, and protein.
      • Vitamins and minerals are optional
  • Include succinct statements on menus to provide reference for customers
    • Menus must include the following statement “2,000 calories a day is used for general nutrition advice, but calorie needs vary”
    • They must also include a statement about the availability of full nutrition information upon customer request

 

Where do restaurants need to display nutrition?

  • Calories must be posted on all menus and menu boards next to the item name or price
    • Menu and menu boards include, but are not limited to, breakfast, lunch, and dinner menus; dessert menus; beverage menus; children’s menus; other specialty menus; electronic menus; and online menus.
  • Complete nutrition must be available upon customer request at all locations
    • This information can be displayed in many different ways including on a computer, tablet, digital menu board, and/or kiosk.

 

I am a restaurant operator, where do I begin?

  • If you have already analyzed your menu’s nutrition, that’s great!
    • Check how recently it was updated and gather a team at your brand to make sure it is up-to-date
    • Come up with a strategy for disseminating the information (see next sub-bullet points for more details)
  • If you are starting from scratch, that’s okay too!
    • Connect with your operations team to compile all recipes and spec sheets for your menu
    • Contact a nutrition analysis company to analyze your menu. Here are three types:
      • Self Analysis – Analyze your menu with nutrition analysis software (Time-intensive)
      • Database Analysis Company – Registered Dietitians conduct the analysis (Recommended)
      • Chemical Laboratory Analysis – Food items are sent to labs to be analyzed (used mostly for fried foods)
    • Determine how you want the information presented to customers in the easiest and most reproducible format
      • If you print a brochure and send to all locations, you may have to start all over in a few weeks when menus change and resend.
      • Consider interactive nutrition tools to let customers view live updates of nutrition on smartphones, tablets and desktop computers.
  • Let Nutritionix manage your nutrition information
    • With over 10 years of experience developing nutrition and allergen calculators for chains such as Red Lobster and Jason’s Deli, Nutritionix is your one stop shop for nutrition management.
    • Nutritionix offers menu labeling compliance consulting services to guide you step by step through the process
    • Want to learn more? Sign up for our upcoming FDA menu labeling webinar! The webinar will be held on multiple dates throughout December.  Not a webinar fan? Sign up above for a one-on-one consultation call.

 

Full list of operators who must comply:

  • Bakeries
  • Cafeterias
  • Coffee Shops
  • Convenience Stores
  • Delicatessens
  • Food Service Facilities within Entertainment Venues, such as
    • Amusement Parks
    • Bowling Alleys
    • Movie Theaters
  • Food Service Vendors, such as
    • Ice Cream Shops
    • Mall Cookie Counters
  • Food Take-Out & Delivery
  • Grocery Stores
  • Retail Confectionery Stores
  • Superstores
  • Quick Service Restaurants
  • Full Service Restaurants

 

Danielle Colley, MS, RD
Danielle Colley, MS, RD
Director, Nutrition
[email protected]

 


About Nutritionix:

Nutritionix is the world’s leading provider of interactive nutrition tools for restaurant chains.  Our web-based management platform allows restaurants to instantly publish nutrition data to the web, mobile web, and digital menu boards. Nutritionix offers menu labeling consulting services to ensure your brand stays compliant.  For more information, contact us via email at [email protected]

Nutritionix app now available on iOS

by mattsilv on September 19, 2014  |  Topics: Announcements

The official Nutritionix iOS app is now available on the iOS app store.  The app provides instant access our growing database of over 380,000 foods, including over 600 popular restaurant chains.  The Nutritionix app is free for all users.

Visit below to download the app:
https://itunes.apple.com/us/app/nutritionix-nutrition-database/id917647392

FDA Proposes Changes to Iconic Nutrition Label

by mattsilv on February 28, 2014  |  Topics: Announcements
proposed-fda-nutrition-labelNew Proposed Nutrition Label

On Thursday, Feb. 27th 2014, the FDA formally proposed changes to the nutrition facts label.   For 20 years, consumers have relied on the iconic nutrition label to view the nutrition information on over 500,000 grocery products in the U.S.  What are the biggest changes?

1. New “Added Sugars” Value

The 2010 Dietary Guidelines for Americans states that intake of added sugar is too high in the U.S. population and should be reduced. The FDA proposes to include “added sugars” on the label to help consumers know how much sugar has been added to the product.

 

2. Realistic Serving Size Requirements

Update serving size requirements to reflect the amounts people currently eat.

fda-infographic

 

3. Require Potassium and Vitamin D

Vitamin D is important for its role in bone health. Potassium is beneficial in lowering blood pressure. Vitamins A and C would no longer be required on the label, though manufacturers could declare them voluntarily.

 

4. Remove “Calories from Fat”

Research has shown that the type of fat is more important than the amount of calories from fat.

 

5. Revised Recommended Daily Value for Sodium, Fiber, Vitamin D

Daily Values are used to calculate the Percent Daily Value on the label, which helps consumers understand the nutrition information in the context of a total daily diet.

To view the full list of proposed changes, see the FDA’s press release.

 

About Nutritionix

Nutritionix aggregates nutrition data for over 230,000 grocery products, and over 100,000 restaurant menu items.  On average, over 1 Million consumers view Nutritionix data each month to research what they are eating.

 

 

Free Enterprise API access for San Francisco Food Hackathon Participants

by mattsilv on November 13, 2013  |  Topics: Announcements, API

We understand the importance of innovation in the food industry.  We also believe that with full access to our API of 300K+ foods, nutrition data, and UPC/barcodes, hackers can accomplish amazing innovations in nutrition.

The Future of Food Hackathon is happening this weekend in San Francisco.  Any participants can e-mail us at api at nutritionix dot com to get free Enterprise access to our API for the duration of the weekend hackathon.

In addition, we will have engineering staff monitoring our support forum all day Saturday and Sunday from 9AM PST – 7PM PST.

Key Resources

1.  Get an API key, and e-mail us (api at nutritionix dot com) to let us know you are a participant.

2.  Check out our quick-start guide and documentation.

3.  Bookmark our Support Forum link.

Enterprise API access will be activated for participants who have notified us at 10AM PST on Saturday 11/16/2013.  Access will be downgraded back to our throttled plan at 9PM PST on Sunday 11/17/2013.

 

Nutritionix Launches API v1.1

by mattsilv on August 9, 2013  |  Topics: API

api_diagram

Since we launched our API v1.0 on January 1st, 2013, over 1,000 nutrition innovators have signed up. Thanks to the tremendous support and feedback, we are pleased to announce the launch of Nutritionix API v1.1. This release is jam-packed with new features:

1.  Now Serving Over 300K Unique Foods

We are continuously updating our food database, and we now include over 300,000 unique food items from restaurants, grocery stores, and the USDA.  This includes data from over 15,000 different food brands!

2.  Barcode Scanning

We now officially support barcode scanning in v1.1.  Users love the ability to scan food items from their mobile phone.  Pass a UPC to our /ITEM endpoint and view the full nutrition panel and ingredient statement. We have over 230K UPCs, with more being added every day.

3.  Advanced Querying

Advanced API querying allows you to filter nutrition results in any way imaginable. Run boolean queries, multi-field queries, wildcard searches, and much more.  Check out the docs.

4.  Smarter Search

Our search endpoint keeps getting smarter.  Pass a brand name in and we return all of the results from that brand.  Check out an example search for McDonald’s.  In addition, our search is now even more accurate for combination searches of brand name and item name.  Try searching Kashi GoLean.

5.  AJAX Apps Now Supported

Due to popular demand, we now support IP filtering, which will allow your web app to utilize cross-origin resource sharing.  This will allow you to create nutrition apps using client-side libraries such as JQuery or Backbone.js.  To enable IP filtering, go to the access details section of your developer account.

Ready to get started? Jump into our API v1.1 documentation here: https://developer.nutritionix.com/docs/v1_1

Need any API key?  Head on over to developer.nutritionix.com.

Have questions?  Head over to the Developer Forum.

Introducing: The jQuery Nutrition Label Plugin

by mattsilv on March 8, 2013  |  Topics: Announcements, API

nutritionlabel-1

Ever tried to code a nutrition label in HTML?

It is not easy!  Holding true to our mission of making nutrition information more accessible,  we are releasing what we hope to be the first of many open-source tools to help developers and food brands share nutrition data.

Check out our project on GitHub:
https://github.com/nutritionix/nutrition-label

See a live demo of the jQuery Nutrition Label

HTML5 and Mobile Friendly

The goals of the open nutrition label project are simple:

  • Closely resemble the FDA-standard nutrition label used on most packaged foods
  • Display properly in common desktop and mobile web browsers
  • Automatically calculate the Daily Value % based on a customizable recommended daily calorie intake (not limited to just 2000!)

Calling all Bloggers, Developers, and Hackers

Some example uses of the open nutrition label include:

  • Posting nutrition information for a recipe on your blog
  • Displaying nutrition information for a packaged good
  • Viewing the nutritional details of an item in a diet-tracking app

The possibilities are endless.  We will continue improving the label, but we would love to hear your input and feature requests via the GitHub issues tracker.

The Future of Nutrition Labels

frontlabel

As nutrition labeling standards are bound to change, it is important for any websites listing nutrition information to similarly adhere to new standards, and our open nutrition label project aims to improve that.  With your help, we can rapidly improve the ways we display nutrition data on the web.

About Nutritionix

Founded in 2010, Nutritionix has a mission to make nutrition information more accessible. By partnering with restaurants and food manufacturers, Nutritionix provides a critical link between the companies creating nutrition information, and the consumers who need to access that data.

Nutrition API

Nutritionix developed an API to let developers innovate with nutrition data.  Check it out!

Nutritionix Beta API has launched!

by mattsilv on December 31, 2012  |  Topics: Announcements, API

We want to thank everyone for their patience as we prepared to get the Nutritionix API ready for beta launch.  Ready to dive right in?

Please note: While our beta API has now launched, please keep in mind that we are uploading new nutrition data, and improving our existing data every day.  Please take time to post feature requests and vote on them to ensure we can rapidly improve our API for all developers.

1.  Developer Survey

Make sure you first have already filled out the developer survey.  Note: If you received our e-mail announcing the beta launch, you have most likely already filled out the developer survey.

2.  Sign up for your API key

Visit our 3Scale page to apply for your API key.  Please note, that only developers who have filled out the developer survey will be approved for the API key.

API KEY Signup: https://nutritionix.3scale.net/

3.  View Documentation

Our documentation is still in a temporary format via Google Doc.  Please view it here.

4.  Participate in our discussion forum

We are using Reddit to manage our feature requests and discussions.  Please visit our subreddit and subscribe.

Introduce yourself on the Reddit forum, and meet your fellow nutrition developers!

5.  Check out our public GitHub repo

Visit the Nutritionix public GitHub repo to get API library resources, and other cool scripts that help you interact with the Nutritionix API.

Anything not covered?  Please post questions here.

We look forward to seeing your app!

Nutritionix API Update

by mattsilv on December 7, 2012  |  Topics: API

Greetings developers!  We have been hard at work pushing to launch the Nutritionix API as soon as possible, and we now have some more definite details to share with everyone.

API Beta Launch Date: December 31st, 2012
API Proxy/Management Service:  3Scale.net

Current Waiting List Sign-Up: nutritionix.com/api (Posted on September 10th, 2012)

# Developers: 200+
# Food Brands in API:
~4,000
# Items in API: ~60,000

Real-Time API Pricing:
Access to our real-time nutrition API is 100% FREE with the following conditions:

  • Calls must be made in real-time, not cached*
  • You must include attribution text to Nutritionix on any page that is displaying data from the API
  • Up to 250,000 API calls per month (higher threshold available upon request)

* With written persmission, data may be cached for historical diet tracking apps

Bulk Restaurant Data Export:
Currently, only our restaurant data is available to export in bulk data format.

To purchase a license for our bulk restaurant data export, please contact us at ENTERPRISE at nutritionix dot com.

The beta launch of the API will include three types of items:

  • Common Foods (such as celery, carrots, etc)
  • CPG (such as Gatorade, Dannon Yogurt, etc)
  • Restaurant Items (such as McDonald’s Cheeseburger)

 

Nutritionix API Fields

The current public API fields we will be organizing are listed below.

Important Note: 
Not every item in the nutrition database will have every attribute available.  If an attribute is not available for a particular item, it will return “NULL” from the API request for that attribute’s value.  Please make sure your app properly handles a null request, and displays the information as “N/A” to the end user and not as zero.

field-namefield-description
idNutritionix Unique ID for Item
item nameItem full name, such as Turkey Club Sandwich
brand_idNutritionix ID for Food Brand
brand_namevarchar, Full name of food brand
upcinteger
remote_db_keyforeign key for this item in a remote database
remote_db_idid of the database that this item is sourced from
usda_nbd_nonull or integer
category_id1=appetizer,2=entree,3=side dish,4=dessert,5=beverage,6=modifier
allergen_contains_milkboolean (true, false, null)
allergen_contains_eggsboolean (true, false, null)
allergen_contains_fishboolean (true, false, null)
allergen_contains_shellfishboolean (true, false, null)
allergen_contains_tree_nutsboolean (true, false, null)
allergen_contains_peanutsboolean (true, false, null)
allergen_contains_wheatboolean (true, false, null)
allergen_contains_soybeansboolean (true, false, null)
allergen_contains_glutenboolean (true, false, null)
allergen_contains_seedsboolean (true, false, null)
allergen_contains_sulfitesboolean (true, false, null)
flag_gluten_freeboolean (true, false, null)
flag_veganboolean (true, false, null)
flag_vegetarianboolean (true, false, null)
flag_pescatarianboolean (true, false, null)
nf_serving_size_unitIf serving size is 1 cup, the unit would have a value of "cup"
nf_serving_size_qtyIf serving size is 1 cup, the qty would have a value of "1"
nf_serving_weight_gramsIf serving weight is 228g the value would be "228"
nf_servings_per_containerexample: 2
nf_calories
nf_calories_from_fat
nf_total_fat
nf_saturated_fat
nf_monounsaturated_fat
nf_polyunsaturated_fat
nf_trans_fatty_acid
nf_cholesterol
nf_sodium
nf_total_carbohydrate
nf_dietary_fiber
nf_sugars
nf_protein
nf_vitamin_a_iuTotal IUs of vitamin A (5,000 IU is RDI)
nf_vitamin_a_dvdaily value percentage expressed as integer
nf_vitamin_c_mgTotal mgs of Vitamin C (60mg is RDI)
nf_vitamin_c_dvdaily value percentage expressed as integer
nf_calcium_mgTotal Mgs of Calcium (1,000mg is RDI)
nf_calcium_dvdaily value percentage expressed as integer
nf_iron_mgTotal mgs Iron (18mg is RDI)
nf_iron_dvdaily value percentage expressed as integer
import-idMatches this row's data to the import it came from
timestamp_last_updated
last_updated_user
timestamp_created


*Seeking API Volunteers*

We are seeking five volunteers to help with testing, documentation, and bug tracking for our alpha stage API starting today.  Before you apply, please note we require the following:

  • Volunteer at least 3 hours per week to the API project
  • Sign our NDA agreement
  • Experience with the following are a huge plus, but not required:
    • PHP / Yii Framework
    • 3Scale.net
    • GitHub
    • Amazon Web Services
Still interested?  Please e-mail us at API at nutritionix dot com, and include the following brief details:
  • How much time can you volunteer to our API per week
  • Which of the above items do you have experience with?
  • Please provide a link to your GitHub profile
  • What type of app will you be using/developing to test the API?
Please feel free to submit questions in the comments below.  Thank you!
- Nutritionix Team
Back to Nutritionix.com