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-name | field-description |
| id | Nutritionix Unique ID for Item |
| item name | Item full name, such as Turkey Club Sandwich |
| brand_id | Nutritionix ID for Food Brand |
| brand_name | varchar, Full name of food brand |
| upc | integer |
| remote_db_key | foreign key for this item in a remote database |
| remote_db_id | id of the database that this item is sourced from |
| usda_nbd_no | null or integer |
| category_id | 1=appetizer,2=entree,3=side dish,4=dessert,5=beverage,6=modifier |
| allergen_contains_milk | boolean (true, false, null) |
| allergen_contains_eggs | boolean (true, false, null) |
| allergen_contains_fish | boolean (true, false, null) |
| allergen_contains_shellfish | boolean (true, false, null) |
| allergen_contains_tree_nuts | boolean (true, false, null) |
| allergen_contains_peanuts | boolean (true, false, null) |
| allergen_contains_wheat | boolean (true, false, null) |
| allergen_contains_soybeans | boolean (true, false, null) |
| allergen_contains_gluten | boolean (true, false, null) |
| allergen_contains_seeds | boolean (true, false, null) |
| allergen_contains_sulfites | boolean (true, false, null) |
| flag_gluten_free | boolean (true, false, null) |
| flag_vegan | boolean (true, false, null) |
| flag_vegetarian | boolean (true, false, null) |
| flag_pescatarian | boolean (true, false, null) |
| nf_serving_size_unit | If serving size is 1 cup, the unit would have a value of "cup" |
| nf_serving_size_qty | If serving size is 1 cup, the qty would have a value of "1" |
| nf_serving_weight_grams | If serving weight is 228g the value would be "228" |
| nf_servings_per_container | example: 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_iu | Total IUs of vitamin A (5,000 IU is RDI) |
| nf_vitamin_a_dv | daily value percentage expressed as integer |
| nf_vitamin_c_mg | Total mgs of Vitamin C (60mg is RDI) |
| nf_vitamin_c_dv | daily value percentage expressed as integer |
| nf_calcium_mg | Total Mgs of Calcium (1,000mg is RDI) |
| nf_calcium_dv | daily value percentage expressed as integer |
| nf_iron_mg | Total mgs Iron (18mg is RDI) |
| nf_iron_dv | daily value percentage expressed as integer |
| import-id | Matches 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
